struttura RPC_BINDING_VECTOR (rpcdce.h)

Articolo
03/01/2024

La struttura RPC_BINDING_VECTOR contiene un elenco di handle di associazione su cui un'applicazione server può ricevere chiamate di routine remote.

Sintassi

typedef struct _RPC_BINDING_VECTOR {
  unsigned long      Count;
  RPC_BINDING_HANDLE BindingH[1];
} RPC_BINDING_VECTOR;

Members

Count

Numero di handle di associazione presenti nella matrice binding-handle BindingH.

BindingH[1]

Matrice di handle di associazione che contiene gli elementi Count .

Commenti

Il vettore di associazione contiene un membro count (Count), seguito da una matrice di elementi binding-handle (BindingH).

La libreria di runtime RPC crea handle di associazione quando un'applicazione server registra le sequenze di protocollo. Per ottenere un vettore di associazione, un'applicazione server chiama RpcServerInqBindings.

Un'applicazione client ottiene un vettore di associazione di server compatibili dal database name-service chiamando RpcNsBindingLookupNext.

In entrambe le routine, la libreria di runtime RPC alloca memoria per il vettore di associazione. Un'applicazione chiama RpcBindingVectorFree per liberare il vettore di associazione.

Per rimuovere un singolo handle di associazione dal vettore, l'applicazione deve impostare il valore nel vettore su NULL. Quando si imposta un elemento vettore su NULL, l'applicazione deve:

Liberare il singolo binding.
Non modificare il valore di Count.

La chiamata a RpcBindingFree consente a un'applicazione di liberare tutti gli handle di associazione nel vettore.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	rpcdce.h (include Rpc.h)