IDeviceTopology::Metode GetSubunit (devicetopology.h)

  • Artikel

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
E_INVALIDARG
 Parameter nIndex berada di luar rentang.
E_POINTER
 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

Lihat juga

Antarmuka IDeviceTopology

IDeviceTopology::GetSubunitCount

Antarmuka ISubunit