RpcServerInterfaceGroupInqBindings-Funktion (rpcdce.h)

Die RpcServerInterfaceGroupInqBindings-Funktion gibt die Bindungshandles zurück, über die Remoteprozeduraufrufe für die angegebene Schnittstellengruppe empfangen werden können.

Syntax

RPC_STATUS RpcServerInterfaceGroupInqBindings(
  [in]  RPC_INTERFACE_GROUP IfGroup,
  [out] RPC_BINDING_VECTOR  **BindingVector
);

Parameter

[in] IfGroup

Ein RPC_INTERFACE_GROUP von RpcServerInterfaceGroupCreate , der die Schnittstellengruppe definiert, für die die Bindungen abgefragt werden sollen.

[out] 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 RpcServerInterfaceGroupInqBindings auf, um einen Vektor von Serverbindungshandles für die angegebene Schnittstellengruppe abzurufen. Die RPC-Laufzeitbibliothek erstellt Bindungshandles für eine Schnittstellengruppe, wenn eine Serveranwendung die RpcServerInterfaceGroupActivate-Funktion aufruft .

Der zurückgegebene Bindungsvektor kann abhängig von der Endpunktspezifikation der Schnittstellengruppe Bindungshandles mit dynamischen Endpunkten oder Bindungshandles mit bekannten Endpunkten enthalten.

Ein Server verwendet den Vektor von Bindungshandles für den Export in den Namensdienst oder für die Konvertierung in Zeichenfolgenbindungen. Wenn keine Bindungshandles vorhanden sind (keine registrierten Protokollsequenzen), gibt RpcServerInterfaceGroupInqBindingsRPC_S_NO_BINDINGS zurück, und BindingVector ist NULL. Der Server ist für den Aufruf von RpcBindingVectorFree verantwortlich, um den Speicher des Vektors freizugeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	rpcdce.h (rpc.h einschließen)
Bibliothek	Rpcrt4.lib
DLL	Rpcrt4.dll

Weitere Informationen

RpcServerInterfaceGroupActivate

RpcServerInterfaceGroupClose

RpcServerInterfaceGroupCreate

RpcServerInterfaceGroupDeactivate