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
               rpc_server_listen
               dce_server_disable_service

   Books: OSF DCE Application Development Guide