IPartsList ::GetPart, méthode (devicetopology.h)

La méthode GetPart obtient un composant de la liste des composants.

Syntaxe

HRESULT GetPart(
  [in]  UINT  nIndex,
  [out] IPart **ppPart
);

Paramètres

[in] nIndex

Numéro de pièce de la partie à récupérer. Si la liste des parties contient n parties, les parties sont numérotées de 0 à n– 1. Appelez la méthode IPartsList ::GetCount pour obtenir le nombre de parties dans la liste.

[out] ppPart

Pointeur vers une variable de pointeur dans laquelle la méthode écrit l’adresse de l’interface IPart de l’objet de partie. Grâce à cette méthode, l’appelant obtient une référence comptabilisée à l’interface IPart . 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 GetPart échoue, *ppPart 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_INVALIDARG	Le paramètre nIndex est hors de la plage.
E_POINTER	Le pointeur ppPart a lavaleur NULL.

Remarques

Pour obtenir un exemple de code qui appelle la méthode GetPart , consultez l’implémentation de la fonction SelectCaptureDevice dans Topologies d’appareil.

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

IPart Interface

IPartsList, interface

IPartsList ::GetCount