Partager via


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

La méthode ConnectTo connecte ce connecteur à un connecteur dans un autre objet de topologie d’appareil.

Syntaxe

HRESULT ConnectTo(
  [in] IConnector *pConnectTo
);

Paramètres

[in] pConnectTo

Autre connecteur. Ce paramètre pointe vers l’interface IConnector de l’objet connecteur qui représente le connecteur dans l’autre topologie d’appareil. L’appelant est chargé de libérer sa référence comptabilisée à l’interface IConnector quand elle n’est plus nécessaire. La méthode ConnectTo obtient sa propre référence à cette interface.

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 pConnectTo a la valeur NULL.
E_INVALIDARG
Le connecteur actuel et le connecteur distant pointés vers pConnectTo ont la même direction de flux de données. Un connecteur dont la direction du flux de données est « In » doit être connecté à un autre connecteur avec le sens de flux de données « Out » pour créer une connexion valide dans la topologie. Pour déterminer le flux de données d’un connecteur, appelez IConnector::GetDataFlow.
E_NOINTERFACE
L’objet pointé vers pConnectTo n’est pas un objet connecteur valide.
HRESULT_FROM_WIN32(ERROR_DEVICE_ALREADY_ATTACHED)
L’un des deux connecteurs est déjà attaché à un autre connecteur. Pour plus d’informations sur cette macro, consultez la documentation du Kit de développement logiciel (SDK) Windows.

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