PreviousNext

dce_server_disable_service(3dce)

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.

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:

rpc_intro(3rpc)

dce_server_enable_service(3dce)

dce_server_register(3dce)

Book: OSF DCE Application Development Guide - Core Components