RpcServerInqBindings-Funktion (rpcdce.h)

Artikel
03/13/2024

Die RpcServerInqBindings-Funktion gibt die Bindungshandles zurück, über die Remoteprozeduraufrufe empfangen werden können.

Syntax

RPC_STATUS RpcServerInqBindings(
  RPC_BINDING_VECTOR **BindingVector
);

Parameter

BindingVector

Gibt einen Zeiger auf einen Zeiger auf einen Vektor von Serverbindungshandles zurück.

Rückgabewert

Wert	Bedeutung
RPC_S_OK	Der Aufruf war erfolgreich.
RPC_S_NO_BINDINGS	Es sind keine Bindungen vorhanden.

Hinweis Eine Liste der gültigen Fehlercodes finden Sie unter RPC-Rückgabewerte.

Hinweise

Eine Serveranwendung ruft RpcServerInqBindings auf, um einen Vektor von Serverbindungshandles abzurufen. Die RPC-Laufzeitbibliothek erstellt Bindungshandles, wenn eine Serveranwendung die folgenden Funktionen aufruft, um Protokollsequenzen zu registrieren:

Der zurückgegebene Bindungsvektor kann Bindungshandles mit dynamischen Endpunkten oder Bindungshandles mit bekannten Endpunkten enthalten, je nachdem, welche der oben genannten Funktionen von der Serveranwendung aufgerufen wurde.

Ein Server verwendet den Vektor der Bindungshandles für den Export in den Namensdienst, für die Registrierung bei der lokalen Endpunktzuordnungsdatenbank oder für die Konvertierung in Zeichenfolgenbindungen. Wenn keine Bindungshandles vorhanden sind (keine registrierten Protokollsequenzen), gibt diese Routine den RPC_S_NO_BINDINGS status Code und den BindingVector-Parameterwert NULL zurück. Der Server ist für den Aufruf der RpcBindingVectorFree-Funktion verantwortlich, um den vom Vektor verwendeten Arbeitsspeicher freizugeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	rpcdce.h (include Rpc.h)
Bibliothek	Rpcrt4.lib
DLL	Rpcrt4.dll