NAME
   dce_msg_cat_get_msg - DCE message text retrieval routine

 SYNOPSIS

   #include <dce/dce_msg.h>

   unsigned char *dce_msg_cat_get_msg( dce_msg_cat_handle_t handle,
                                       unsigned32 message,
                                       error_status_t *status );

 PARAMETERS

   Input

   message
          The ID of the message to be retrieved.

   handle
          A handle (returned by dce_msg_cat_open()) to an opened message
          catalog.

   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

   Once the catalog has been opened with the dce_msg_cat_open() routine,
   the dce_msg_cat_get_msg() routine can be used to retrieve the text
   for a specified message (which is a 32-bit DCE message ID as described
   in dce_error_inq_text). If the specified message cannot be found
   in the catalog, the routine returns a NULL and fills in status with
   the appropriate error code.

 ERROR CODES

   See dce_msg_get.

 RELATED INFORMATION

   Functions: dce_msg_cat_close
              dce_msg_cat_open
              dce_msg_get_cat_msg
              dce_msg_get
              dce_msg_get_msg