Previous section.

CDE 1.1: Remote Procedure Call
Copyright © 1997 The Open Group

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:

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.

Contents Next section Index