Méthode IConnector::GetConnectedTo (devicetopology.h)

La méthode GetConnectedTo obtient le connecteur auquel ce connecteur est connecté.

Syntaxe

HRESULT GetConnectedTo(
  [out] IConnector **ppConTo
);

Paramètres

[out] ppConTo

Pointeur vers une variable de pointeur dans laquelle la méthode écrit l’adresse de l’interface IConnector de l’autre objet connecteur. Grâce à cette méthode, l’appelant obtient une référence comptée à l’interface. L’appelant est chargé de libérer l’interface, lorsqu’elle n’est plus nécessaire, en appelant la méthode Release de l’interface. Si l’appel GetConnectedTo échoue, *ppConTo a la valeur NULL.

Valeur retournée

Si la méthode réussit, retourne S_OK. En cas d’échec, les codes de retour possibles incluent, sans s’y limiter, les valeurs indiquées dans le tableau suivant.

Code de retour	Description
E_POINTER	Le pointeur ppConTo a lavaleur NULL.
E_NOTFOUND	Ce connecteur n’est pas connecté ou l’autre côté de la connexion n’est pas une autre topologie d’appareil (par exemple, une connexion Software_IO).
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)	La topologie de l’appareil de l’autre côté de la connexion n’est pas active (autrement dit, l’état de l’appareil n’est pas DEVICE_STATE_ACTIVE).

Notes

Pour obtenir des exemples de code qui appellent cette méthode, consultez les implémentations des fonctions GetHardwareDeviceTopology et SelectCaptureDevice dans Topologies d’appareil.

Pour plus d’informations sur les connexions Software_IO, consultez ConnectorType, énumération. Pour plus d’informations sur la macro HRESULT_FROM_WIN32, consultez la documentation du Kit de développement logiciel (SDK) Windows. Pour plus d’informations sur l’état de l’appareil DEVICE_STATE_NOTPRESENT, consultez constantes DEVICE_STATE_XXX.

Spécifications

Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	devicetopology.h

Voir aussi

IConnector Interface