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

tableA 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

handleA serviceability handle structure that 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(3dce).