PreviousNext

The DCE Messaging Routines

The messaging routines are as follows, listed in alphabetical order:

dce_error_inq_text( )
Retrieves from the installed DCE component message catalogs the message text associated with an error status code returned by a DCE library routine.

dce_fprintf( )
Functions much like dce_printf( ), except that it prints the message and its arguments on the specified stream.

dce_msg_cat_close( )
Closes the message catalog (which was opened with dce_msg_cat_open( )).

dce_msg_cat_get_msg( )
Retrieves the text for a specified message.

dce_msg_cat_open( )
Opens the message catalog that contains the specified message, and returns a handle that can be used in subsequent calls to dce_msg_cat_get_msg( ).

dce_msg_define_msg_table( )
Registers an in-memory table containing the messages.

dce_msg_get( )
Retrieves the text for a specified message. A convenience form of the dce_msg_get_msg( ) routine.

dce_msg_get_cat_msg( )
A "convenience" form of the dce_msg_cat_get_msg( ) routine. Unlike dce_msg_cat_get_msg( ), dce_msg_get_cat_msg( ) does not require the message catalog to be explicitly opened.

dce_msg_get_default_msg( )
Retrieves a message from the application's in-memory tables.

dce_msg_get_msg( )
Retrieves the text for a specified message.

dce_msg_translate_table( )
The dce_msg_translate_table( ) routine overwrites the specified in-memory message table with the values from the equivalent message catalogs.

dce_pgm_fprintf( )
Equivalent to dce_fprintf( ), except that it prepends the program name and appends a newline.

dce_pgm_printf( )
Equivalent to dce_printf( ), except that it prepends the program name and appends a newline.

dce_pgm_sprintf( )
Equivalent to dce_sprintf( ), except that it prepends the program name and appends a newline.

dce_printf( )
Retrieves the message text associated with the specified message ID, and prints the message and its arguments on the standard output.

dce_sprintf( )
Retrieves the message text associated with the specified message ID, and prints the message and its arguments into an allocated string that is returned.