IDeviceTopology::GetSubunit-Methode (devicetopology.h)
Die GetSubunit-Methode ruft die Untereinheit ab, die durch eine Untereinheitsnummer angegeben wird.
Syntax
HRESULT GetSubunit(
[in] UINT nIndex,
[out] ISubunit **ppSubunit
);
Parameter
[in] nIndex
Die Untereinheitsnummer. Wenn eine Gerätetopologie n Untereinheiten enthält, werden die Untereinheiten von 0 bis n– 1 nummeriert. Rufen Sie die IDeviceTopology::GetSubunitCount-Methode auf, um die Anzahl der Untereinheiten in der Gerätetopologie abzurufen.
[out] ppSubunit
Zeiger auf eine Zeigervariable, in die die Methode die Adresse der ISubunit-Schnittstelle des Untereinheitsobjekts schreibt. Mit dieser Methode erhält der Aufrufer einen gezählten Verweis auf die Schnittstelle. Der Aufrufer ist für die Freigabe der Schnittstelle verantwortlich, wenn sie nicht mehr benötigt wird, indem er die Release-Methode der Schnittstelle aufruft. Wenn der GetSubunit-Aufruf fehlschlägt, ist *ppSubunitNULL.
Rückgabewert
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, umfassen mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte, sind jedoch nicht darauf beschränkt.
| Rückgabecode | Beschreibung |
|---|---|
|
Parameter nIndex liegt außerhalb des Bereichs. |
|
Der Zeiger ppSubunit ist NULL. |
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | devicetopology.h |