Freigeben über


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
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

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

Weitere Informationen

RpcEpRegister

RpcEpRegisterNoReplace