Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |