_RPC_BINDING_VECTOR structure

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

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.
Calling RpcBindingFree allows an application to free all binding handles in the vector.

Requirements

   
Windows version Windows 2000 Professional [desktop apps only] Windows 2000 Server [desktop apps only]
Header rpcdce.h (include Rpc.h)

See Also

RpcBindingVectorFree

RpcEpRegister

RpcEpRegisterNoReplace

RpcEpUnregister

RpcNsBindingExport

RpcNsBindingLookupNext

RpcNsBindingSelect

RpcServerInqBindings