RpcMgmtIsServerListening-Funktion (rpcdce.h)
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 |
|---|---|
|
Server, der auf Remoteprozeduraufrufe lauscht. |
|
Der Server lauscht nicht auf Remoteprozeduraufrufe, oder die Schnittstelle lauscht automatisch. |
|
Das Bindungshandle war ungültig. |
|
Dies war die falsche Art der Bindung für den Vorgang. |
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 |