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 |
|---|---|
|
Parameter nIndex liegt außerhalb des Bereichs. |
|
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 |