rpc_ns_binding_select- returns a binding handle from a list of compatible binding handles
void rpc_ns_binding_select( rpc_binding_vector_t *binding_vec, rpc_binding_handle_t *binding, unsigned32 *status);
- Specifies the vector of compatible server binding handles from which a binding handle is selected. The returned binding vector no longer references the selected binding handle (which is returned separately in binding).
- Returns a selected server binding handle.
- 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 more bindings.
The rpc_ns_binding_select() routine randomly chooses and returns a server binding handle from a vector of server binding handles.
Each time the application calls the rpc_ns_binding_select() routine, the routine returns another binding handle from the vector.
When all of the binding handles are returned from the vector, the routine returns a status code of rpc_s_no_more_bindings and returns the value NULL in binding.
The RPC run-time system allocates storage for the data referenced by the returned binding. When an application finishes with the binding handle, it calls the rpc_binding_free() routine to deallocate the storage. Each call to the rpc_ns_binding_select() routine requires a corresponding call to the rpc_binding_free() routine.
- Instead of using this routine, applications can select a binding handle according to their specific needs. In this case the rpc_binding_to_string_binding() and rpc_string_binding_parse() routines are useful to the applications since the routines work together to extract the individual fields of a binding handle for examination.
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.