NAME
   dce_msg_get_cat_msg - Opens message catalog and retrieves message

 SYNOPSIS

   #include <dce/dce_msg.h>

   unsigned char *dce_msg_get_cat_msg( unsigned32 message,
                                       error_status_t *status );

 PARAMETERS

   Input

   message
          ID of message to be retrieved.

   Output

   status
          Returns the status code from this operation. The status code
          is a value that indicates whether the routine completed
          successfully and if not, why not.

 DESCRIPTION

   The dce_msg_get_cat_msg() routine is a "convenience" form of the
   dce_msg_cat_get_msg() routine. The difference between it and the
   latter routine is that dce_msg_get_cat_msg() does not require the
   message catalog to be explicitly opened; it determines the correct
   catalog from the message parameter (which is a 32-bit DCE message
   ID as described in dce_error_inq_text), opens it, retrieves the
   message, and returns a pointer to malloc()'d space containing the
   message. If the message catalog is inaccessible, the routine returns
   an error.  (See the routine dce_msg_get() for a description of the
   return value.)

   The routine will fail if the message catalog is not correctly
   installed.

 ERROR CODES

   See dce_msg_get.

 RELATED INFORMATION

   Functions: dce_msg_cat_close
              dce_msg_cat_get_msg
              dce_msg_cat_open
              dce_msg_get
              dce_msg_get_msg