Fonction RpcMgmtIsServerListening (rpcdce.h)
La fonction RpcMgmtIsServerListening indique si un serveur écoute les appels de procédure distante.
Syntaxe
RPC_STATUS RpcMgmtIsServerListening(
RPC_BINDING_HANDLE Binding
);
Paramètres
Binding
Pour déterminer si une application distante écoute les appels de procédure distante, spécifiez un handle de liaison de serveur pour cette application. Pour déterminer si votre propre application (locale) écoute les appels de procédure distante, spécifiez la valeur NULL.
Valeur retournée
| Valeur | Signification |
|---|---|
|
Serveur à l’écoute des appels de procédure distante. |
|
Le serveur n’écoute pas les appels de procédure distante, ou l’interface est à l’écoute automatique. |
|
Le handle de liaison n’était pas valide. |
|
Il s’agissait du mauvais type de liaison pour l’opération. |
La fonction RpcMgmtIsServerListening retourne des résultats corrects uniquement pour les interfaces qui ne sont pas à l’écoute automatique. Si l’application serveur écoute automatiquement et appelle la fonction RpcMgmtIsServerListening , RpcMgmtIsServerListening retourne RPC_SERVER_NOT_LISTENING, mais le serveur peut être à l’écoute et les appels RPC suivants peuvent réussir.
Remarques
Une application appelle la fonction RpcMgmtIsServerListening pour déterminer si le serveur spécifié dans le paramètre Binding écoute les appels de procédure distante.
La fonction RpcMgmtIsServerListening retourne une valeur de RPC_S_OK si le serveur a appelé RpcServerListen.
Le serveur doit être à l’écoute des appels de procédure distante pour que cette fonction réussisse. Si le serveur n’écoute pas, la fonction échoue.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau | Applications UWP] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau | Applications UWP] |
| Plateforme cible | Windows |
| En-tête | rpcdce.h (inclure Rpc.h) |
| Bibliothèque | Rpcrt4.lib |
| DLL | Rpcrt4.dll |