NAME

rpc_ep_resolve_binding- resolves a partially bound server binding handle into a fully bound server binding handle

SYNOPSIS

#include <dce/rpc.h>

void rpc_ep_resolve_binding(
	rpc_binding_handle_t binding,
	rpc_if_handle_t if_handle,
	unsigned32 *status);

PARAMETERS

Input/Output

binding

Specifies a partially bound server binding handle to resolve into a fully bound server binding handle.

if_handle

Contains a stub-generated data structure that specifies the interface of interest.

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.

ept_s_not_registered

No entries found.

DESCRIPTION

An application calls the rpc_ep_resolve_binding() routine to resolve a partially bound server binding handle into a fully bound server binding handle.

To resolve a binding, rpc_ep_resolve_binding() obtains an endpoint for a compatible server instance from the endpoint map of the host specified by binding. In selecting an endpoint, rpc_ep_resolve_binding() uses the interface UUID associated with if_handle and the object UUID associated with binding. The object UUID may be the nil UUID. The endpoint matching algorithm is described in tagmref_rpc_ep_register .

The resolved binding returned by rpc_ep_resolve_binding() depends on whether the specified binding handle is partially bound or fully bound. When the application specifies a partially bound handle, the routine produces the following results:

• If no compatible server instances are registered in the endpoint map, the routine returns the ept_s_not_registered status code.

• If one compatible server instance is registered in the local endpoint map, the routine returns a fully bound binding handle in binding and the rpc_s_ok status code.

• If more than one compatible server instance is registered in the local endpoint map, the routine arbitrarily selects one. It then returns the corresponding fully bound binding handle in binding and the rpc_s_ok status code.

When the application specifies a fully bound binding handle, the routine returns the specified binding handle in binding and the rpc_s_ok status code.

RETURN VALUE

None.

SEE ALSO

rpc_ep_register()
rpc_ep_register_no_replace()
rpc_mgmt_ep_elt_inq_begin()
rpc_mgmt_ep_elt_inq_done()
rpc_mgmt_ep_elt_inq_next()
rpc_binding_from_string_binding()
rpc_binding_reset().

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.