Metode IPropertyStorage::ReadMultiple (propidl.h)

Artikel
03/13/2024

Metode ReadMultiple membaca properti tertentu dari kumpulan properti saat ini.

Sintaks

HRESULT ReadMultiple(
  [in]  ULONG             cpspec,
  [in]  const PROPSPEC [] rgpspec,
  [out] PROPVARIANT []    rgpropvar
);

Parameter

[in] cpspec

Jumlah numerik properti yang akan ditentukan dalam array rgpspec . Nilai parameter ini dapat diatur ke nol; namun, yang mengalahkan tujuan metode karena tidak ada properti yang dibaca, terlepas dari nilai yang ditetapkan dalam rgpspec.

[in] rgpspec

Array struktur PROPSPEC menentukan properti mana yang dibaca. Properti dapat ditentukan baik dengan ID properti atau dengan nama string opsional. Tidak perlu menentukan properti dalam urutan tertentu dalam array. Array dapat berisi properti duplikat, menghasilkan nilai properti duplikat yang dikembalikan untuk properti sederhana. Properti nonsimple harus mengembalikan akses yang ditolak pada upaya untuk membukanya untuk kedua kalinya. Array dapat berisi campuran ID properti dan ID string.

[out] rgpropvar

Array yang dialokasikan penelepon dari struktur PROPVARIANT yang, saat dikembalikan, berisi nilai properti yang ditentukan oleh elemen terkait dalam array rgpspec . Array harus setidaknya cukup besar untuk menyimpan nilai parameter cpspec dari struktur PROPVARIANT . Parameter cpspec menentukan jumlah properti yang diatur dalam array. Pemanggil tidak diperlukan untuk menginisialisasi nilai struktur PROPVARIANT ini dalam urutan tertentu. Namun, implementasi harus mengisi semua anggota dengan benar saat pengembalian. Jika tidak ada nilai lain yang sesuai, implementasi harus menetapkan anggota vt dari setiap struktur PROPVARIANT ke VT_EMPTY.

Mengembalikan nilai

Metode ini mendukung nilai pengembalian standar E_UNEXPECTED, serta yang berikut ini:

Fungsi ini juga dapat mengembalikan kesalahan sistem file atau kesalahan Win32 yang dibungkus dalam jenis data HRESULT . Untuk informasi selengkapnya, lihat Strategi Penanganan Kesalahan.

Untuk informasi selengkapnya, lihat Pertimbangan Penyimpanan Properti.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows 2000 Server [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	propidl.h (termasuk Objbase.h, Propidlbase.h)
Pustaka	Uuid.lib
DLL	Ole32.dll