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_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.

ERROR CODES

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).