Metode IDiscMaster2::get__NewEnum (imapi2.h)

  • Artikel

Mengambil daftar perangkat CD dan DVD yang terinstal pada komputer.

Sintaks

HRESULT get__NewEnum(
  [out] IEnumVARIANT **ppunk
);

Parameter

[out] ppunk

Antarmuka IEnumVariant yang Anda gunakan untuk menghitung perangkat CD dan DVD yang diinstal di komputer. Item enumerasi adalah varian yang jenisnya VT_BSTR. Gunakan anggota bstrVal untuk mengambil pengidentifikasi unik perangkat.

Mengembalikan nilai

S_OK dikembalikan ketika jumlah elemen yang diminta (celt) berhasil dikembalikan atau jumlah item yang dikembalikan (pceltFetched) kurang dari jumlah elemen yang diminta. Parameter celt dan pceltFetched didefinisikan oleh IEnumVariant.

Kode keberhasilan lainnya dapat dikembalikan sebagai akibat dari implementasi. Kode kesalahan berikut biasanya dikembalikan pada kegagalan operasi, tetapi tidak mewakili satu-satunya nilai kesalahan yang mungkin:

Menampilkan kode Deskripsi
E_POINTER
 Penunjuk tidak valid.

Nilai: 0x80004003

Keterangan

Enumerasi adalah rekam jepret perangkat di komputer pada saat panggilan dan tidak akan mencerminkan perangkat yang ditambahkan dan dihapus. Untuk menerima pemberitahuan saat perangkat ditambahkan atau dihapus dari komputer, terapkan antarmuka DDiscMaster2Events .

Untuk mengambil satu pengidentifikasi, lihat properti IDiscMaster2::get_Item .

Pengidentifikasi perangkat dijamin unik dan statis untuk perangkat tertentu seperti yang dikenali oleh Windows Plug and Play. Anda dapat menggunakan pengidentifikasi sebagai nilai kunci untuk menyimpan pembakar default pengguna, dan juga dapat digunakan untuk menyimpan informasi statis khusus perangkat lainnya (misalnya, VendorID dan ProductID) oleh aplikasi tingkat lanjut.

Persyaratan

   
Klien minimum yang didukung Windows Vista, Windows XP dengan SP2 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header imapi2.h

Lihat juga

IDiscMaster2

IDiscMaster2::get_Count