Name

dce_msg_cat_open − DCE message catalog open routine

Synopsis

#include <dce/dce_msg.h> dce_msg_cat_handle_t dce_msg_cat_open(
unsigned32 message_ID,
error_status_t ∗status);

Parameters

Input

message_IDThe ID of the message to be retrieved. 

Output

statusReturns 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_cat_open() routine opens the message catalog that contains the specified message_ID.  It returns a handle that can be used in subsequent calls to dce_msg_cat_get_msg().  On error, it returns NULL and fills in status with an appropriate error code. 

Errors

The following describes a partial list of errors that might be returned.  Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. 

See dce_msg_get(3dce). 

Related Information

Functions:  dce_msg_cat_close(3dce), dce_msg_cat_get_msg(3dce), dce_msg_get(3dce), dce_msg_get_cat_msg(3dce), dce_msg_get_msg(3dce).