NAME

dce_server_disable_service - Disables an individual service of a server

SYNOPSIS

#include <dce/dced.h>
void                                  dce_server_disable_service(
        dce_server_handle_t     server_handle,
        rpc_if_handle_t         interface,
        error_status_t          *status);

PARAMETERS

Input

server_handle

An opaque handle returned by dce_server_register().

interface

Specifies an opaque variable containing information the runtime uses to access interface specification data.

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_disable_service() routine disables an individual service that a server provides by unregistering the service's interface from the RPC runtime and marking the server's endpoints as disabled in the local dced's endpoint mapper service.

For dced to recognize all of a server's services, a server should register all its application services using the dce_server_register() routine. If it later becomes necessary for the server to disable an interface, it can use the dce_server_disable_service() routine rather than unregistering the entire server.

RELATED INFORMATION

Routines:   rpc_intro(3rpc),
            dce_server_enable_service(3dce),    dce_server_register(3dce).

Books: OSF DCE Application Development Guide.