DCE_SVC_DEFINE_HANDLE(3dce)

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