CoIsHandlerConnected, fonction (combaseapi.h)

Détermine si un objet distant est connecté à l’objet en cours de traitement correspondant.

Syntaxe

BOOL CoIsHandlerConnected(
  [in] LPUNKNOWN pUnk
);

Paramètres

[in] pUnk

Pointeur vers l’interface IUnknown de contrôle sur l’objet distant.

Valeur retournée

Si l’objet n’est pas distant ou s’il est distant et toujours connecté, la valeur de retour est TRUE ; sinon, elle est FALSE.

Remarques

La fonction CoIsHandlerConnected détermine le status d’un objet distant. Vous pouvez l’utiliser pour déterminer quand libérer un objet distant. Vous spécifiez l’objet distant en donnant à la fonction un pointeur vers son interface IUnknown de contrôle (paramètre pUnk ). La valeur TRUE renvoyée par la fonction indique soit que l’objet spécifié n’est pas distant, soit qu’il est distant et qu’il est toujours connecté à son gestionnaire distant. La valeur FALSE renvoyée par la fonction indique que l’objet est distant, mais n’est plus connecté à son gestionnaire distant ; dans ce cas, l’appelant doit répondre en libérant l’objet.

Configuration requise