| ## rpc_mgmt_stop_server_listening(3rpc) Tells a server to stop listening for remote procedure calls Used by client, server, or management applications. Synopsis #include <dce/rpc.h>( void rpc_mgmt_stop_server_listening( rpc_binding_handle_t binding, unsigned32 *status); Parameters Input binding Specifies a server binding handle. To direct a remote server to stop listening for remote procedure calls, specify a server binding handle to that server. To direct your own (local) server to stop listening for remote procedure calls, specify NULL. If the binding handle you supply refers to partially bound binding information and the binding information contains a nil object UUID, this routine returns the rpc_s_binding_incomplete status code. In this case, the DCE Host Daemon does not know which server instance to select from the local endpoint map because the RPC management interface is automatically registered (by the RPC runtime) for all RPC servers. To avoid this situation, you can obtain a fully bound server binding handle by calling rpc_ep_resolve_binding( ). Output status Returns the status code from this routine. This status code indicates whether the routine completed successfully or, if not, why not. status can also return the value of parameter status from the application-defined authorization function rpc_mgmt_authorization_fn_t( ). The prototype for such a function is defined in the authorization_fn parameter in the reference page for rpc_mgmt_set_authorization_fn(3rpc). Description The rpc_mgmt_stop_server_listening( ) routine directs a server to stop listening for remote procedure calls. On receiving such a request, the DCE RPC runtime stops accepting new remote procedure calls. Executing calls are allowed to complete. After all calls complete, rpc_server_listen( ) returns to the caller. By default, the RPC runtime does not allow any client to remotely call this routine. To allow clients to execute this routine, a server application supplies an authorization function using rpc_mgmt_set_authorization_fn( ). Return Values No value is returned. 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. rpc_s_ok Success. rpc_s_binding_incomplete Binding incomplete (no object ID and no endpoint). rpc_s_comm_failure Communications failure. rpc_s_invalid_binding Invalid binding handle. rpc_s_mgmt_op_disallowed Management operation disallowed. rpc_s_unknown_if Unknown interface. rpc_s_wrong_kind_of_binding Wrong kind of binding for operation. Related Information Functions: rpc_ep_resolve_binding(3rpc) rpc_mgmt_set_authorization_fn(3rpc) rpc_server_listen(3rpc) ##