IDeviceTopology::Metode GetSubunit (devicetopology.h)
Metode GetSubunit mendapatkan subunit yang ditentukan oleh nomor subunit.
Sintaks
HRESULT GetSubunit(
[in] UINT nIndex,
[out] ISubunit **ppSubunit
);
Parameter
[in] nIndex
Nomor subunit. Jika topologi perangkat berisi subunit n , subunit dinomor dari 0 hingga n– 1. Untuk mendapatkan jumlah subunit dalam topologi perangkat, panggil metode IDeviceTopology::GetSubunitCount .
[out] ppSubunit
Arahkan ke variabel pointer tempat metode menulis alamat antarmuka ISubunit dari objek subunit. Melalui metode ini, penelepon mendapatkan referensi yang dihitung ke antarmuka. Pemanggil bertanggung jawab untuk merilis antarmuka, ketika tidak lagi diperlukan, dengan memanggil metode Rilis antarmuka. Jika panggilan GetSubunit gagal, *ppSubunit adalah NULL.
Nilai kembali
Jika metode berhasil, metode akan mengembalikan S_OK. Jika gagal, kemungkinan kode pengembalian menyertakan, tetapi tidak terbatas pada, nilai yang diperlihatkan dalam tabel berikut.
| Menampilkan kode | Deskripsi |
|---|---|
|
Parameter nIndex berada di luar rentang. |
|
Pointer ppSubunit adalah NULL. |
Persyaratan
| Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2008 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | devicetopology.h |