IPartsList::GetPart-Methode (devicetopology.h)

Die GetPart-Methode ruft einen Teil aus der Teileliste ab.

Syntax

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

Parameter

[in] nIndex

Die Teilenummer des abzurufenden Teils. Wenn die Teileliste n Teile enthält, sind die Teile 0 bis n–1 nummeriert. Rufen Sie die IPartsList::GetCount-Methode auf, um die Anzahl der Teile in der Liste abzurufen.

[out] ppPart

Zeiger auf eine Zeigervariable, in die die -Methode die Adresse der IPart-Schnittstelle des Part-Objekts schreibt. Mit dieser Methode erhält der Aufrufer einen gezählten Verweis auf die IPart-Schnittstelle . Der Aufrufer ist für das Freigeben der Schnittstelle verantwortlich, wenn sie nicht mehr benötigt wird, indem die Release-Methode der Schnittstelle aufgerufen wird. Wenn der GetPart-Aufruf fehlschlägt, ist *ppPartNULL.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, können mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte umfassen, sind jedoch nicht darauf beschränkt.

Rückgabecode	Beschreibung
E_INVALIDARG	Parameter nIndex liegt außerhalb des Bereichs.
E_POINTER	Zeiger ppPart ist NULL.

Hinweise

Ein Codebeispiel, das die GetPart-Methode aufruft, finden Sie in der Implementierung der SelectCaptureDevice-Funktion in Gerätetopologien.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	devicetopology.h

Weitere Informationen

IPart-Schnittstelle

IPartsList-Schnittstelle

IPartsList::GetCount