dce_server_unregister(3dce)

Synopsis

#include <dce/dced.h>

void dce_server_unregister(

dce_server_handle_t *server_handle,

error_status_t *status);

Parameters

Input

server_handle
An opaque handle returned by dce_server_register( ).

Output

status
Returns the status code from this routine. This status code indicates whether the routine completed successfully. The only status code is error_status_ok.

Description
The dce_server_unregister( ) routine unregisters a DCE server by unregistering a servers services (interfaces) from the RPC runtime. When a server has stopped listening for remote procedure calls, it should call this routine.

The flags set with the corresponding dce_server_register( ) routine are part of the server handle's information used to determine what action to take or not take. These actions include removing the server's endpoints from the dced endpoint mapper service and unexporting binding information from the namespace.

Use the dce_server_disable_service( ) routine to disable specific application services rather than unregistering the whole server.

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.

Related Information
Routines: dce_server_register(3dce)

rpc_server_listen(3rpc)

dce_server_disable_service(3dce)

Book: OSF DCE Application Development Guide - Core Components