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
RPC_S_OK	L’appel a réussi.
RPC_S_INVALID_BINDING	Le handle de liaison n’était pas valide.
RPC_S_WRONG_KIND_OF_BINDING	Il s’agissait du mauvais type de liaison pour l’opération.

 

Note Pour obtenir la liste des codes d’erreur valides, consultez Valeurs de retour RPC.

 

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.

Note Côté client, RpcMgmtStopServerListening est désactivé par défaut. Pour activer cette fonction, créez une fonction d’autorisation dans votre application serveur qui retourne TRUE (pour autoriser un arrêt à distance) chaque fois que RpcMgmtStopServerListening est appelé. Utilisez RpcMgmtSetAuthorizationFn pour accorder au client l’accès à la fonction de gestion.

 

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.

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

Voir aussi

RpcEpResolveBinding

RpcMgmtWaitServerListen

RpcServerListen

RpcServerRegisterIfEx