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

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'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.

RELATED INFORMATION

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

Books: OSF DCE Application Development Guide.