NAME

rpc_mgmt_stop_server_listening- tells a server to stop listening for remote procedure calls

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 for the server that is to stop listening for remote procedure calls. Specifying NULL causes the application itself to stop listening.

Output

status

Returns the status code from this routine. The status code indicates whether the routine completed successfully, or if not, why not.

Possible status codes and their meanings include:

rpc_s_ok

Success.

rpc_s_comm_failure

Communications failure.

rpc_s_mgmt_op_disallowed

Management operation disallowed.

rpc_s_unknown_if

Server does not support this interface.

rpc_s_binding_incomplete

Binding lacks both an object UUID and an endpoint.

In addition to the above values, status can return the value of status from an application-defined authorisation function. The prototype for such a function is defined in the authorization_fn argument description in tagmref_rpc_mgmt_set_authorization_fn .

DESCRIPTION

The rpc_mgmt_stop_server_listening() routine directs a server to stop listening for remote procedure calls.

On receipt of such a request, the RPC run-time system stops accepting new remote procedure calls.

RETURN VALUE

None.

SEE ALSO

rpc_server_listen()
rpc_mgmt_set_authorization_fn()
rpc_ep_resolve_binding().

Please note that the html version of this specification may contain formatting aberrations. The definitive version is available as an electronic publication on CD-ROM from The Open Group.