RpcBindingFree-Funktion (rpcdce.h)

Artikel
08/25/2023

Die RpcBindingFree-Funktion gibt Binding-Handle-Ressourcen frei.

Syntax

RPC_STATUS RpcBindingFree(
  RPC_BINDING_HANDLE *Binding
);

Parameter

Binding

Zeiger auf die zu freigebende Serverbindung.

Rückgabewert

Wert	Bedeutung
RPC_S_OK	Der Aufruf war erfolgreich.
RPC_S_INVALID_BINDING	Das Bindungshandle war ungültig.
RPC_S_WRONG_KIND_OF_BINDING	Dies war die falsche Art der Bindung für den Vorgang.

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

Hinweise

Die RpcBindingFree-Funktion gibt Arbeitsspeicher frei, der von einem Serverbindungshandle verwendet wird. Außerdem werden referenzierte Bindungsinformationen veröffentlicht, die während der Programmausführung dynamisch erstellt wurden. Eine Anwendung ruft die RpcBindingFree-Funktion auf, wenn sie mit dem Bindungshandle abgeschlossen ist. RPC-Bindungshandles dürfen erst freigegeben werden, wenn alle Aufrufe, die das Handle verwenden, abgeschlossen sind. wenn dies nicht geschieht, führt dies zu unvorhersehbaren Ergebnissen.

Bindungshandles werden dynamisch erstellt, indem die folgenden Funktionen aufgerufen werden:

Wenn der Vorgang die Bindung erfolgreich freigibt, gibt der Binding-Parameter den Wert NULL zurück.

Hinweis Microsoft RPC unterstützt RpcBindingFree nur in Clientanwendungen oder in Serveranwendungen für Bindungshandles, die mit RpcBindingServerFromClient generiert werden.

Anforderungen


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