RpcNsBindingSelect function (rpcnsi.h)
The RpcNsBindingSelect function returns a binding handle from a list of compatible binding handles.
Syntax
RPC_STATUS RpcNsBindingSelect(
RPC_BINDING_VECTOR *BindingVec,
RPC_BINDING_HANDLE *Binding
);
Parameters
BindingVec
Pointer to the vector of client-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 the Binding parameter.
Binding
Pointer to a selected binding handle.
Return value
| Value | Meaning |
|---|---|
|
The call succeeded. |
|
No more bindings. |
Remarks
Each time the client calls the RpcNsBindingSelect function, the function operation returns another binding handle from the vector.
When all of the binding handles have been returned from the vector, the function returns a status of RPC_S_NO_MORE_BINDINGS and returns a Binding value of NULL.
The select operation allocates storage for the data referenced by the returned Binding parameter. When a client finishes with the binding handle, it should call the RpcBindingFree function to deallocate the storage. Each call to RpcNsBindingSelect requires a corresponding call to the RpcBindingFree function.
Clients can create their own select routines implementing application-specific selection criteria. In this case, RpcStringBindingParse provides access to the fields of a binding.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | rpcnsi.h (include Rpc.h) |
| Library | Rpcns4.lib |
| DLL | Rpcns4.dll |