RpcMgmtStopServerListening, fonction (rpcdce.h)
La fonction RpcMgmtStopServerListening indique à un serveur d’arrêter d’écouter les appels de procédure distante. Cette fonction n’affecte pas les interfaces d’écoute automatique. Pour plus d’informations, consultez RpcServerRegisterIfEx .
Syntaxe
RPC_STATUS RpcMgmtStopServerListening(
RPC_BINDING_HANDLE Binding
);
Paramètres
Binding
Pour indiquer à une application distante d’arrêter l’écoute des appels de procédure distante, spécifiez un handle de liaison de serveur pour cette application. Pour indiquer à votre propre application (locale) d’arrêter l’écoute des appels de procédure distante, spécifiez la valeur NULL.
Valeur retournée
| Valeur | Signification |
|---|---|
|
L’appel a réussi. |
|
Le handle de liaison n’était pas valide. |
|
Il s’agissait du mauvais type de liaison pour l’opération. |
Notes
Une application appelle la fonction RpcMgmtStopServerListening pour demander à un serveur d’arrêter d’écouter les appels de procédure distante. Si DontWait a la valeur TRUE, l’application doit appeler RpcMgmtWaitServerListen pour attendre la fin de tous les appels.
Lorsqu’elle reçoit une demande d’arrêt d’écoute, la bibliothèque d’exécution RPC cesse d’accepter de nouveaux appels de procédure distante pour toutes les interfaces inscrites. L’exécution des appels est autorisée, y compris les rappels. Une fois tous les appels terminés, cette fonction signale à la fonction RpcServerListen qu’elle doit cesser d’écouter et revenir à l’appelant. Si le paramètre DontWait de RpcServerListen a été défini sur TRUE, l’application appelle RpcMgmtWaitServerListen pour que tous les appels restants se terminent.
Spécifications
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | rpcdce.h (inclure Rpc.h) |
| Bibliothèque | Rpcrt4.lib |
| DLL | Rpcrt4.dll |