NAME

rpc_mgmt_is_server_listening- tells whether a server is listening for remote procedure calls

SYNOPSIS

#include <dce/rpc.h>

boolean32 rpc_mgmt_is_server_listening(
	rpc_binding_handle_t binding,
	unsigned32 *status);

PARAMETERS

Input

binding

Specifies a server binding handle. To determine if a remote server is listening for remote procedure calls, the application specifies a server binding handle for that server. To determine if the application itself is listening for remote procedure calls, the application specifies NULL.

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

Not authorised for operation.

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_is_server_listening() routine determines whether the server specified in the binding argument is listening for remote procedure calls.

This routine returns a value of TRUE if the server has called the rpc_server_listen() routine.

RETURN VALUE

Returns one of the Boolean values TRUE or FALSE.

The following table gives the interpretation of each possible combination of return value and status value.

Value Returned	Status Code	Explanation
TRUE	rpc_s_ok	The specified server is listening for remote procedure calls.
FALSE	rpc_s_ok or rpc_s_comm_failure	The specified server is not listening for remote procedure calls, or the server could not be reached.
FALSE	rpc_s_mgmt_op_disallowed	Not authorised for operation.

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.