RPC_BINDING_VECTOR-Struktur (rpcdce.h)

Artikel
03/01/2024

Die RPC_BINDING_VECTOR-Struktur enthält eine Liste von Bindungshandles, über die eine Serveranwendung Remoteprozeduraufrufe empfangen kann.

Syntax

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

Member

Count

Anzahl der Bindungshandles, die im Binding-Handle-Array BindingH vorhanden sind.

BindingH[1]

Array von Bindungshandles, das Count-Elemente enthält.

Hinweise

Der Bindungsvektor enthält einen Count-Member (Count), gefolgt von einem Array von Binding-Handle-Elementen (BindingH).

Die RPC-Laufzeitbibliothek erstellt Bindungshandles, wenn eine Serveranwendung Protokollsequenzen registriert. Um einen Bindungsvektor zu erhalten, ruft eine Serveranwendung RpcServerInqBindings auf.

Eine Clientanwendung ruft einen Bindungsvektor kompatibler Server aus der Name-Dienst-Datenbank ab, indem rpcNsBindingLookupNext aufgerufen wird.

In beiden Routinen belegt die RPC-Laufzeitbibliothek Arbeitsspeicher für den Bindungsvektor. Eine Anwendung ruft RpcBindingVectorFree auf, um den Bindungsvektor frei zu geben.

Um ein einzelnes Bindungshandle aus dem Vektor zu entfernen, muss die Anwendung den Wert im Vektor auf NULL festlegen. Wenn Sie ein Vektorelement auf NULL festlegen, muss die Anwendung:

Geben Sie die einzelne Bindung frei.
Ändern Sie den Wert von Count nicht.

Durch Aufrufen von RpcBindingFree kann eine Anwendung alle Bindungshandles im Vektor freigeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	rpcdce.h (rpc.h einschließen)