Export (0) Print
Expand All
Expand Minimize

RpcNsBindingSelect function

The RpcNsBindingSelect function returns a binding handle from a list of compatible binding handles.

Note  This function is not supported on Windows Vista and later operating systems.

Syntax


RPC_STATUS RPC_ENTRY 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

ValueMeaning
RPC_S_OK

The call succeeded.

RPC_S_NO_MORE_BINDINGS

No more bindings.

 

Note  For a list of valid error codes, see RPC Return Values.

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

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Rpcnsi.h (include Rpc.h)

Library

Rpcns4.lib

DLL

Rpcns4.dll

See also

RpcBindingFree
RpcNsBindingLookupNext
RpcStringBindingParse
select

 

 

Community Additions

ADD
Show:
© 2014 Microsoft