Metode IPerPropertyBrowsing::GetPredefinedValue (ocidl.h)

Artikel
03/15/2023

Mengambil nilai properti yang ditentukan yang terkait dengan nama string yang telah ditentukan sebelumnya. Properti ini dikaitkan dengan nama string yang telah ditentukan sebelumnya seperti yang dikembalikan dari IPerPropertyBrowsing::GetPredefinedStrings. String yang telah ditentukan sebelumnya diidentifikasi oleh token yang dikembalikan dari GetPredefinedStrings.

Sintaks

HRESULT GetPredefinedValue(
  [in]  DISPID  dispID,
  [in]  DWORD   dwCookie,
  [out] VARIANT *pVarOut
);

Parameter

[in] dispID

Pengidentifikasi pengiriman properti yang meminta nilai yang telah ditentukan sebelumnya.

[in] dwCookie

Token yang mengidentifikasi nilai mana yang akan dikembalikan. Token sebelumnya dikembalikan dalam array pCaCookiesOut yang diisi oleh GetPredefinedStrings.

[out] pVarOut

Penunjuk ke nilai VARIAN untuk properti .

Nilai kembali

Metode ini dapat mengembalikan nilai pengembalian standar E_INVALIDARG, E_OUTOFMEMORY, dan E_UNEXPECTED, serta nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil diselesaikan.
E_NOTIMPL	Objek ini tidak mendukung string yang telah ditentukan sebelumnya atau nilai yang telah ditentukan sebelumnya.
E_POINTER	Alamat di pVarOut tidak valid. Misalnya, mungkin NULL.

Keterangan

Catatan untuk Penelepon

Pemanggil bertanggung jawab untuk membebaskan alokasi apa pun yang terkandung dalam VARIAN. Kecuali anggota vtVARIAN VT_VARIANT, pemanggil dapat membebaskan memori menggunakan satu panggilan ke VariantClear. Jika tidak, pemanggil harus secara rekursif membebaskan nilai VARIAN yang terkandung sebelum membebaskan VARIAN luar.

Catatan untuk Pelaksana

Dukungan untuk nama dan nilai yang telah ditentukan sebelumnya tidak diperlukan. Jika objek Anda tidak mendukung nama-nama ini, kembalikan E_NOTIMPL dari metode ini. Jika metode ini tidak diimplementasikan, IPerPropertyBrowsing::GetPredefinedStrings juga tidak boleh diimplementasikan.

Metode ini mengalokasikan memori apa pun yang diperlukan di dalam VARIAN.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	ocidl.h

Lihat juga

IPerPropertyBrowsing

Bagikan melalui