NAME

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(3dce)), 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(3dce)
.

RELATED INFORMATION

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