Previous section.

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

NAME

rpc_ns_binding_select- returns a binding handle from a list of compatible binding handles

SYNOPSIS

#include <dce/rpc.h>

void rpc_ns_binding_select( rpc_binding_vector_t *binding_vec, rpc_binding_handle_t *binding, unsigned32 *status);

PARAMETERS

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.

DESCRIPTION

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.

RETURN VALUE

None.

SEE ALSO


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