PreviousNext

dce_svc_unregister(3dce)

Destroys a serviceability handle

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.

Errors

The following describes a partial list of errors that might be returned. Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages.

See dce_svc_register(3dce).

Related Information
Functions: dce_svc_register(3dce)