Metode IPropertyStorage::ReadPropertyNames (propidl.h)

  • Artikel

Metode ReadPropertyNames mengambil nama string yang ada untuk ID properti yang ditentukan.

Sintaks

HRESULT ReadPropertyNames(
  [in]      ULONG           cpropid,
  [in]      const PROPID [] rgpropid,
  [in, out] LPOLESTR []     rglpwstrName
);

Parameter

[in] cpropid

Jumlah elemen pada input rgpropid array. Nilai parameter ini dapat diatur ke nol, namun yang mengalahkan tujuan metode ini karena tidak ada nama properti yang dibaca.

[in] rgpropid

Array ID properti yang namanya akan diambil.

[in, out] rglpwstrName

Array cpropid ukuran anggota LPWSTR yang dialokasikan penelepon. Saat kembali, implementasi mengisi array ini. Entri yang diberikan berisi nama string yang sesuai dari ID properti atau dapat kosong jika ID properti tidak memiliki nama string.

Setiap anggota LPWSTR dari array harus dikosongkan menggunakan fungsi CoTaskMemFree .

Nilai kembali

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

Keterangan

Untuk setiap ID properti dalam daftar ID properti yang disediakan dalam array rgpropid , ReadPropertyNames mengambil nama string yang sesuai, jika ada. Nama string dibuat baik dengan menentukan nama dalam panggilan ke IPropertyStorage::WriteMultiple saat membuat properti, atau melalui panggilan ke IPropertyStorage::WritePropertyNames. Dalam kedua kasus, nama string bersifat opsional, namun semua properti harus memiliki ID properti.

Nama string yang dipetakan ke ID properti harus unik dalam set.

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

Lihat juga

IPropertyStorage

IPropertyStorage::WriteMultiple

IPropertyStorage::WritePropertyNames