RpcBindingUnbind-Funktion (rpcasync.h)

  • Artikel

Die RpcBindingUnbind-Funktion hebt die Bindung eines Bindungshandles auf, das zuvor von RpcBindingBind gebunden wurde.

Syntax

RPC_STATUS RpcBindingUnbind(
  [in] RPC_BINDING_HANDLE Binding
);

Parameter

[in] Binding

RPC_BINDING_HANDLE Struktur, die das Bindungshandle zum Aufheben der Bindung an den RPC-Server enthält.

Rückgabewert

Diese Funktion gibt RPC_S_OK nach Erfolg zurück. Andernfalls wird ein RPC_S_*-Fehlercode zurückgegeben.

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

Hinweise

RpcBindingUnbind hebt die Bindung eines zuvor gebundenen Bindungshandles an einen RPC-Server auf. Ein ungebundenes Handle kann mit Aufrufen wie RpcBindingSetOption und RpcBindingSetAuthInfoEx geändert werden. Ein Bindungshandle im ungebundenen Zustand kann erneut gebunden und für Aufrufe wieder verwendet werden.

Die Ergebnisse eines nicht gebundenen Vorgangs sind undefiniert, wenn er für ein Bindungshandle aufgerufen wird, das zum Zeitpunkt der Aufhebung der Bindung derzeit RPC-Aufrufe ausgeführt hat. Es liegt in der Verantwortung des Aufrufers sicherzustellen, dass zum Zeitpunkt des Versuches eines nicht bindungslosen Vorgangs keine Aufrufe ausgeführt werden.

Beachten Sie, dass beim Aufrufen von RpcBindingUnbind nicht notwendigerweise die Verbindung zwischen dem Client und dem Server hergestellt wird. Es werden alle zwischengespeicherten Informationen ungültig, die vom Bindungshandle verwendet werden, aber tatsächlich ist die Trennung nicht sichergestellt. Um die Trennung sicherzustellen, geben Sie das Bindungshandle mit RpcBindingFree frei.

Windows Vista: Derzeit unterstützt diese Funktion nur die ncalrpc-Protokollsequenz .

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista, Windows XP mit SP2 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008, Windows Server 2003 mit SP1 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile rpcasync.h (rpc.h einschließen)
Bibliothek Rpcrt4.lib
DLL Rpcrt4.dll

Weitere Informationen

RpcBindingBind

RpcBindingFree