RpcMgmtStopServerListening-Funktion (rpcdce.h)

Artikel
08/25/2023

Die RpcMgmtStopServerListening-Funktion weist einen Server an, nicht mehr auf Remoteprozeduraufrufe zu lauschen. Diese Funktion wirkt sich nicht auf Schnittstellen zum automatischen Lauschen aus. Weitere Informationen finden Sie unter RpcServerRegisterIfEx .

Syntax

RPC_STATUS RpcMgmtStopServerListening(
  RPC_BINDING_HANDLE Binding
);

Parameter

Binding

Um eine Remoteanwendung anweisen zu können, das Lauschen auf Remoteprozeduraufrufe zu beenden, geben Sie ein Serverbindungshandle für diese Anwendung an. Geben Sie den Wert NULL an, um Ihre eigene (lokale) Anwendung anweisen, das Lauschen auf Remoteprozeduraufrufe zu beenden.

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

Eine Anwendung ruft die RpcMgmtStopServerListening-Funktion auf, um einen Server anzuweisen, das Lauschen auf Remoteprozeduraufrufe zu beenden. Wenn DontWaitTRUE ist, sollte die Anwendung RpcMgmtWaitServerListen aufrufen, um zu warten, bis alle Aufrufe abgeschlossen sind.

Wenn sie eine Anforderung zum Beenden des Lauschens empfängt, akzeptiert die RPC-Laufzeitbibliothek nicht mehr neue Remoteprozeduraufrufe für alle registrierten Schnittstellen. Die Ausführung von Anrufen kann ausgeführt werden, einschließlich Rückrufen. Nachdem alle Aufrufe abgeschlossen sind, signalisiert diese Funktion der RpcServerListen-Funktion , dass sie das Lauschen beenden und an den Aufrufer zurückkehren muss. Wenn der DontWait-Parameter von RpcServerListen auf TRUE festgelegt wurde, ruft die Anwendung RpcMgmtWaitServerListen auf, damit alle verbleibenden Aufrufe abgeschlossen werden.

Hinweis Clientseitig ist RpcMgmtStopServerListening standardmäßig deaktiviert. Um diese Funktion zu aktivieren, erstellen Sie eine Autorisierungsfunktion in Ihrer Serveranwendung, die TRUE zurückgibt (um ein Remote-Herunterfahren zuzulassen), wenn RpcMgmtStopServerListening aufgerufen wird. Verwenden Sie RpcMgmtSetAuthorizationFn , um dem Client Zugriff auf die Verwaltungsfunktion zu gewähren.

Der Server muss auf Remoteprozeduraufrufe lauschen, damit diese Funktion erfolgreich ist. Wenn der Server nicht lauscht, schlägt die Funktion fehl.

Anforderungen


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

Weitere Informationen

RpcEpResolveBinding

RpcMgmtWaitServerListen

RpcServerListen

RpcServerRegisterIfEx

Freigeben über