Partager via

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

  • Article

La méthode GetConnectorIdConnectedTo obtient l’ID global du connecteur, le cas échéant, auquel ce connecteur est connecté.

Syntaxe

HRESULT GetConnectorIdConnectedTo(
  [out] LPWSTR *ppwstrConnectorId
);

Paramètres

[out] ppwstrConnectorId

Pointeur vers un pointeur de chaîne dans lequel la méthode écrit l’adresse d’une chaîne de caractères larges terminée par null qui contient l’ID global de l’autre connecteur. La méthode alloue le stockage pour la chaîne. L’appelant est responsable de libérer le stockage, lorsqu’il n’est plus nécessaire, en appelant la fonction CoTaskMemFree . Si l’appel GetConnectorIdConnectedTo échoue, *ppwstrConnectorId a la valeur NULL. Pour plus d’informations sur CoTaskMemFree, consultez la documentation du Kit de développement logiciel (SDK) Windows.

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_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).
E_POINTER
 Le paramètre ppwstrConnectorId a la valeur NULL.
E_OUTOFMEMORY
 Mémoire insuffisante.

Remarques

Un ID global est une chaîne qui identifie de manière unique une partie parmi toutes les parties de toutes les topologies d’appareil du système. Les clients doivent traiter cette chaîne comme opaque. Autrement dit, les clients ne doivent pas tenter d’analyser le contenu de la chaîne pour obtenir des informations sur la partie. La raison en est que le format de chaîne n’est pas défini et peut changer d’une implémentation de l’API DeviceTopology à la suivante.

Configuration requise

Condition requise Valeur
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