Name

dce_server_unregister - Unregisters a DCE server

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

statusReturns 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 server’s 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’s 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

A representative list of errors that might be returned is not shown here.  Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. 

Related Information

Functions: dce_server_disable_service(3dce), dce_server_register(3dce), rpc_server_listen(3rpc). 

Books: OSF DCE Application Development Guide.