HELPLIB.HLB  —  DCE  DCE_INTRO, dce_msg_intro, dce_msg_translate_table
 NAME
   dce_msg_translate_table - Translates all in-memory messages in
                             a table

 SYNOPSIS

   #include <dce/dce_msg.h>

   void dce_msg_translate_table( dce_msg_table_t *table,
                                 unsigned32 count,
                                 error_status_t *status );

 PARAMETERS

   Input

   table  A message table structure (defined in a header file generated
          by sams during compilation (see "EXAMPLES" below), the
          contents of which are to be translated.

   count  The number of elements contained in the table.

   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_translate_table() routine overwrites the specified
   in-memory message table (that is, updates the in-memory table with
   the contents of a message table, which has changed for some reason;
   for example, because of a change in locale).

   If any in-memory message is not found in the message catalog, all
   in-memory messages are left unchanged.

 EXAMPLES

   The following code fragment shows how dce_msg_translate_table()
   might be called (in an application whose serviceability component
   name is app) to translate a DCE application's in-memory message
   table, set up by an earlier call to dce_msg_define_msg_table():

        #include <dce/dce.h>
        #include <dce/dce_msg.h>
        #include <dce/dcesvcmsg.h>
        #include "dceappmsg.h"

        char                *loc_return;
        error_status_t      status;

                     <. . .>

        dce_msg_translate_table (app_msg_table,
                                 sizeof(app_msg_table) /
                                        sizeof(app_msg_table[0]),
                                 &status );

 ERROR CODES

   See dce_msg_get.

 RELATED INFORMATION

   Functions:  dce_msg_define_msg_table
Close Help