RpcMgmtIsServerListening-Funktion (rpcdce.h)

  • Artikel

Die RpcMgmtIsServerListening-Funktion gibt an, ob ein Server auf Remoteprozeduraufrufe lauscht.

Syntax

RPC_STATUS RpcMgmtIsServerListening(
  RPC_BINDING_HANDLE Binding
);

Parameter

Binding

Um zu bestimmen, ob eine Remoteanwendung Remoteprozeduraufrufe überwacht, geben Sie ein Serverbindungshandle für diese Anwendung an. Geben Sie den Wert NULL an, um zu bestimmen, ob Ihre eigene (lokale) Anwendung Remoteprozeduraufrufe überwacht.

Rückgabewert

Wert Bedeutung
RPC_S_OK
 Server, der auf Remoteprozeduraufrufe lauscht.
RPC_S_NOT_LISTENING
 Der Server lauscht nicht auf Remoteprozeduraufrufe, oder die Schnittstelle lauscht automatisch.
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.
 
 

Die RpcMgmtIsServerListening-Funktion gibt korrekte Ergebnisse nur für Schnittstellen zurück, die nicht automatisch überwacht werden. Wenn die Serveranwendung automatisch lauscht und die RpcMgmtIsServerListening-Funktion aufruft , gibt RpcMgmtIsServerListening RPC_SERVER_NOT_LISTENING zurück, aber der Server lauscht möglicherweise, und nachfolgende RPC-Aufrufe können erfolgreich sein.

Hinweise

Eine Anwendung ruft die RpcMgmtIsServerListening-Funktion auf, um zu bestimmen, ob der im Binding-Parameter angegebene Server auf Remoteprozeduraufrufe lauscht.

Die RpcMgmtIsServerListening-Funktion gibt den Wert RPC_S_OK zurück, wenn der Server RpcServerListen aufgerufen hat.

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

Anforderungen

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

RpcEpResolveBinding

RpcServerListen