Fungsi PSGetPropertyDescription (propsys.h)

Mendapatkan instans antarmuka deskripsi properti untuk properti yang ditentukan oleh struktur PROPERTYKEY .

Sintaks

PSSTDAPI PSGetPropertyDescription(
  [in]  REFPROPERTYKEY propkey,
  [in]  REFIID         riid,
  [out] void           **ppv
);

Parameter

[in] propkey

Jenis: REFPROPERTYKEY

Referensi ke PROPERTYKEY.

[in] riid

Jenis: REFIID

Referensi ke ID antarmuka antarmuka yang diminta.

[out] ppv

Jenis: void**

Ketika fungsi ini kembali, berisi pointer antarmuka yang diminta dalam riid. Ini biasanya IPropertyDescription, IPropertyDescriptionAliasInfo, atau IPropertyDescriptionSearchInfo.

Nilai kembali

Jenis: PSSTDAPI

Mengembalikan salah satu nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Antarmuka diperoleh.
E_INVALIDARG	Parameter ppv adalah NULL.
TYPE_E_ELEMENTNOTFOUND	PROPERTYKEY tidak ada di cache subsistem skema.

Keterangan

Kami menyarankan agar Anda menggunakan makro IID_PPV_ARGS , yang ditentukan dalam Objbase.h, untuk mengemas parameter riid dan ppv . Makro ini menyediakan IID yang benar berdasarkan antarmuka yang diacu oleh nilai dalam ppv, yang menghilangkan kemungkinan kesalahan pengkodian.

Contoh

Contoh berikut, untuk disertakan sebagai bagian dari program yang lebih besar, menunjukkan cara menggunakan PSGetPropertyDescription untuk mendapatkan deskripsi properti untuk properti peringkat.

IPropertyDescription *pPropDesc;

HRESULT hr = PSGetPropertyDescription(PKEY_Ratings, IID_PPV_ARGS(&pPropDesc));

if (SUCCEEDED(hr))
{
    // pPropDesc is now valid.
 
    pPropDesc->Release();
}

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP dengan SP2, Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 dengan SP1 [hanya aplikasi desktop]
Target Platform	Windows
Header	propsys.h
Pustaka	Propsys.lib
DLL	Propsys.dll (versi 6.0 atau yang lebih baru)
Redistribusi	Windows Desktop Search (WDS) 3.0

Lihat juga

PSGetPropertyDescriptionByName

PSGetPropertySystem