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
               dce_server_enable_service
               dce_server_register

   Books: OSF DCE Application Development Guide