RpcBindingUnbind-Funktion (rpcasync.h)
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.
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 |