PreviousNext

dce_msg_cat_open(3dce)

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_ID
The ID of the 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_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_cat_msg(3dce)

dce_msg_get(3dce)

dce_msg_get_msg(3dce)