rpc_ep_resolve_binding- resolves a partially bound server binding handle into a fully bound server binding handle
void rpc_ep_resolve_binding( rpc_binding_handle_t binding, rpc_if_handle_t if_handle, unsigned32 *status);
- Specifies a partially bound server binding handle to resolve into a fully bound server binding handle.
- Contains a stub-generated data structure that specifies the interface of interest.
- 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:
No entries found.
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
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.
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.