IPartsList::Metode GetPart (devicetopology.h)

Artikel
02/28/2024

Metode GetPart mendapatkan bagian dari daftar bagian.

Sintaks

HRESULT GetPart(
  [in]  UINT  nIndex,
  [out] IPart **ppPart
);

Parameter

[in] nIndex

Nomor bagian dari bagian yang akan diambil. Jika daftar bagian berisi bagian n , bagian bernomor 0 hingga n– 1. Panggil metode IPartsList::GetCount untuk mendapatkan jumlah bagian dalam daftar.

[out] ppPart

Pointer ke variabel pointer tempat metode menulis alamat antarmuka IPart dari objek bagian. Melalui metode ini, pemanggil mendapatkan referensi yang dihitung ke antarmuka IPart . Pemanggil bertanggung jawab untuk merilis antarmuka, ketika tidak lagi diperlukan, dengan memanggil metode Rilis antarmuka. Jika panggilan GetPart gagal, *ppPart adalah NULL.

Nilai kembali

Jika metode berhasil, metode akan mengembalikan S_OK. Jika gagal, kemungkinan kode pengembalian disertakan, tetapi tidak terbatas pada, nilai yang diperlihatkan dalam tabel berikut.

Menampilkan kode	Deskripsi
E_INVALIDARG	Parameter nIndex berada di luar rentang.
E_POINTER	Pointer ppPart adalah NULL.

Keterangan

Untuk contoh kode yang memanggil metode GetPart , lihat implementasi fungsi SelectCaptureDevice di Topologi Perangkat.

Persyaratan

Persyaratan	Nilai
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 IPart

Antarmuka IPartsList

IPartsList::GetCount