Using This Routine
For each server instance, the RPC runtime automatically provides routines (the rpc_mgmt_* routines) that form an RPC management interface. If a server instance registers any application-provided interfaces, the RPC runtime automatically registers the RPC-provided management interface with the local endpoint map for that server instance.
An application can call rpc_ep_resolve_binding( ) at any time with either a partially bound or a fully bound handle. However, applications typically call this routine to avoid calling a routine in the management interface with a partially bound handle.
An application can have a partially bound binding handle at the following times:
· After importing a binding handle.
· After resetting a binding handle.
· After converting a string binding without an endpoint to a binding handle.
If an application calls an application-provided remote procedure using a partially bound handle, the RPC runtime automatically asks the DCE Host daemon to resolve the binding handle into a fully bound handle. This fully bound binding handle corresponds to the RPC interface of the called remote procedure and the requested object, if any. The application can then use this fully bound handle to make remote management calls, so calling the rpc_ep_resolve_binding( ) routine is unnecessary.
When a high proportion of all servers in an environment offers the same interface, the interface is known as a pervasive one. The RPC management interface is a pervasive interface in all environments that use DCE RPC.
Using this routine to unambiguously locate compatible server instances applies to application-pervasive interfaces as well as to the RPC management interface.