RpcBindingReset-Funktion (rpcdce.h)
Die RpcBindingReset-Funktion setzt ein Bindungshandle zurück, sodass der Host angegeben wird, der Server auf diesem Host jedoch nicht angegeben ist.
Syntax
RPC_STATUS RpcBindingReset(
RPC_BINDING_HANDLE Binding
);
Parameter
Binding
Zurückzusetzende Serverbindungshandle.
Rückgabewert
| Wert | Bedeutung |
|---|---|
|
Der Aufruf war erfolgreich. |
|
Das Bindungshandle war ungültig. |
|
Dies war die falsche Art der Bindung für den Vorgang. |
Hinweise
Ein Client ruft die RpcBindingReset-Funktion auf, um die Zuordnung eines bestimmten Server-instance zu dem im Binding-Parameter angegebenen Serverbindungshandle zu trennen. Die RpcBindingReset-Funktion entfernt die Zuordnung eines Servers instance, indem der Endpunktteil der Serveradresse im Bindungshandle entfernt wird. Der Host bleibt im Bindungshandle unverändert. Das Ergebnis ist ein teilweise gebundenes Serverbindungshandle.
RpcBindingReset wirkt sich nicht auf die Authentifizierungsinformationen des Binding-Parameters aus, sofern vorhanden.
Wenn ein Client bereit ist, von einem kompatiblen Server instance auf dem im Bindungshandle angegebenen Host gewartet zu werden, ruft der Client die RpcBindingReset-Funktion auf, bevor er mithilfe des Bindungshandles einen Remoteprozeduraufruf durchführt. Clients dürfen die RpcBindingReset-Funktion nicht zum Binden von Handles aufrufen, für die Aufrufe ausgeführt werden.
Wenn der Client den nächsten Remoteprozeduraufruf mithilfe der zurückgesetzten (teilweise gebundenen) Bindung vornimmt, verwendet die RPC-Laufzeitbibliothek des Clients ggf. einen bekannten Endpunkt aus der Schnittstellenspezifikation des Clients. Andernfalls kommuniziert die Laufzeitbibliothek des Clients automatisch mit dem Endpunktzuordnungsdienst auf dem angegebenen Remotehost, um den Endpunkt eines kompatiblen Servers aus der Endpunktzuordnungsdatenbank abzurufen. Wenn sich ein kompatibler Server befindet, aktualisiert die RPC-Laufzeitbibliothek die Bindung mit einem neuen Endpunkt. Wenn kein kompatibler Server gefunden wird, schlägt der Remoteprozeduraufruf fehl. Bei Aufrufen mit einem Verbindungsprotokoll (ncacn) wird der EPT_S_NOT_REGISTERED status Code an den Client zurückgegeben. Bei Aufrufen mit einem Datagrammprotokoll (ncadg) wird der RPC_S_COMM_FAILURE status Code an den Client zurückgegeben.
Serveranwendungen sollten alle Bindungshandles registrieren, indem sie RpcEpRegister und RpcEpRegisterNoReplace aufrufen, wenn der Server für Clients verfügbar sein möchte, die einen Remoteprozeduraufruf für ein Bindungshandle zum Zurücksetzen durchführen.
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 (rpc.h einschließen) |
| Bibliothek | Rpcrt4.lib |
| DLL | Rpcrt4.dll |