RPC_BINDING_VECTOR structure (rpcdce.h)
The RPC_BINDING_VECTOR structure contains a list of binding handles over which a server application can receive remote procedure calls.
Syntax
typedef struct _RPC_BINDING_VECTOR {
unsigned long Count;
RPC_BINDING_HANDLE BindingH[1];
} RPC_BINDING_VECTOR;
Members
Count
Number of binding handles present in the binding-handle array BindingH.
BindingH[1]
Array of binding handles that contains Count elements.
Remarks
The binding vector contains a count member (Count), followed by an array of binding-handle (BindingH) elements.
The RPC run-time library creates binding handles when a server application registers protocol sequences. To obtain a binding vector, a server application calls RpcServerInqBindings.
A client application obtains a binding vector of compatible servers from the name-service database by calling RpcNsBindingLookupNext.
In both routines, the RPC run-time library allocates memory for the binding vector. An application calls RpcBindingVectorFree to free the binding vector.
To remove an individual binding handle from the vector, the application must set the value in the vector to NULL. When setting a vector element to NULL, the application must:
- Free the individual binding.
- Not change the value of Count.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Header | rpcdce.h (include Rpc.h) |