CoInvalidateRemoteMachineBindings, fonction (combaseapi.h)

Indique au gestionnaire de contrôle de service de vider tous les handles de liaison RPC mis en cache pour l’ordinateur spécifié.

Seuls les administrateurs peuvent appeler cette fonction.

Syntaxe

HRESULT CoInvalidateRemoteMachineBindings(
  [in] LPOLESTR pszMachineName
);

Paramètres

[in] pszMachineName

Nom de l’ordinateur pour lequel les handles de liaison doivent être vidés, ou une chaîne vide pour indiquer que tous les handles du cache doivent être vidés.

Valeur retournée

Cette fonction peut retourner les valeurs suivantes.

Remarques

Le gestionnaire de contrôle de service OLE est utilisé par COM pour envoyer des demandes d’activation de composant à d’autres machines. Pour ce faire, ole Service Control Manager gère un cache de handles de liaison RPC pour envoyer des demandes d’activation à l’ordinateur, clé par nom d’ordinateur. Dans des circonstances normales, cela fonctionne bien, mais dans certains scénarios, tels que les batteries de serveurs Web et les situations d’équilibrage de charge, la possibilité de vider ce cache de handles spécifiques peut être nécessaire pour faciliter la connexion à un autre serveur physique du même nom. CoInvalidateRemoteMachineBindings est utilisé à cet effet.

Ole Service Control Manager vide les poignées de liaison inutilisées au fil du temps. Il n’est pas nécessaire d’appeler CoInvalidateRemoteMachineBindings pour ce faire.

Configuration requise