NAME

rpc_binding_server_from_client- converts a client binding handle to a server binding handle

SYNOPSIS

#include <dce/rpc.h>

void rpc_binding_server_from_client(
	rpc_binding_handle_t client_binding,
	rpc_binding_handle_t *server_binding,
	unsigned32 *status);

PARAMETERS

Input

client_binding

Specifies the client binding handle to convert to a server binding handle.

Output

server_binding

Returns a server binding handle.

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.

DESCRIPTION

The rpc_binding_server_from_client() routine converts a client binding handle into a partially bound server binding handle.

An application obtains a client binding handle as an argument passed to a server manager routine from the RPC run-time system during a remote procedure call. When an RPC arrives at a server, the RPC run-time system creates a client binding handle that contains binding information about the calling client host. The run-time system passes the client binding handle to the server manager routine as the first argument. The argument type is rpc_binding_handle_t.

The server binding handle returned from rpc_binding_server_from_client() references binding information that is constructed as follows:

• It contains a network address for the calling client's host but lacks an endpoint. The returned binding handle is thus partially bound.

• It contains the same object UUID used by the calling client. This may be the nil UUID. (See tagmref_rpc_binding_set_object , tagmref_rpc_ns_binding_import_begin , tagmref_rpc_ns_binding_lookup_begin and tagmref_rpc_binding_from_string_binding to see how a client specifies an object UUID for a call.)

• It contains no authentication information.

RETURN VALUE

None.

SEE ALSO

rpc_binding_free()
rpc_binding_set_object
rpc_ep_register()
rpc_ep_register_no_replace()
rpc_ns_binding_import_begin()
rpc_ns_binding_lookup_begin()
rpc_binding_from_string_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.