rpc_ns_binding_select- returns a binding handle from a list of compatible binding handles
#include <dce/rpc.h>
void rpc_ns_binding_select(
rpc_binding_vector_t *binding_vec,
rpc_binding_handle_t *binding,
unsigned32 *status);
Input/Output
- binding_vec
- 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).
Output
- binding
- Returns a selected server binding handle.
- 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.
- rpc_s_no_more_bindings
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.
- Note:
- 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.
Permissions Required
None.
None.
rpc_binding_free()
rpc_binding_to_string_binding()
rpc_ns_binding_lookup_next()
rpc_string_binding_parse().
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 |