VMS Help  —  DCE  DCE_INTRO, dce_svc_macros, DCE_SVC_DEFINE_HANDLE
 NAME
   DCE_SVC_DEFINE_HANDLE - Macro to create a serviceability handle

 SYNOPSIS

   #include <dce/dce.h>

   DCE_SVC_DEFINE_HANDLE( dce_svc_handle_t handle,
                          dce_svc_subcomp_t *table,
                          const idl_char *component_name );

 PARAMETERS

   Input

   table     A message table structure (defined in a header file
             generated by sams during compilation).

   component_name
             The serviceability name of the component, defined in
             the component field of the sams file.

   Output

   handle    A serviceability handle structure which will be filled
             in by the macro.

 DESCRIPTION

   There are two ways to register a serviceability table preparatory to
   using the serviceability interface in an application. The first is to
   create a global variable using the DCE_SVC_DEFINE_HANDLE macro.  The
   first parameter is the serviceability handle, the second is a pointer
   to the component's message table, and the third is the name of the
   serviceability component (application).  The macro creates a skeleton
   variable that will be completed the first time the handle is used.
   This can be useful when writing library code that has no explicit
   initialization routine.

   The second method is to call the dce_svc_register() routine.

 RELATED INFORMATION

   Functions: dce_svc_register
Close Help