NAME

SYNOPSIS

#include <dce/dce.h>

void dce_svc_unregister(
        dce_svc_handle_t handle,
        error_status_t *status);

PARAMETERS

Input

handle

The application's serviceability handle, originally returned by a call to dce_svc_register(), or filled in by the DCE_SVC_DEFINE_HANDLE() macro

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_svc_unregister() routine destroys a serviceability handle. Calling it closes any open serviceability message routes and frees all allocated resources associated with the handle.

The handle parameter is the serviceability handle that was originally returned by the call to dce_svc_register(), or filled in by the DCE_SVC_DEFINE_HANDLE() macro. On error, the routine fills in status with an error code.

Note that it is not usually necessary to call this routine, since the normal process exit will perform the required cleanup.

ERROR CODES

See: dce_svc_register(3dce)
.

RELATED INFORMATION

Functions: dce_svc_register(3dce).