Fungsi PSGetPropertyDescriptionListFromString (propsys.h)

Artikel
08/25/2023

Mendapatkan instans antarmuka daftar deskripsi properti untuk daftar properti tertentu.

Sintaks

PSSTDAPI PSGetPropertyDescriptionListFromString(
  [in]  LPCWSTR pszPropList,
  [in]  REFIID  riid,
  [out] void    **ppv
);

Parameter

[in] pszPropList

Jenis: LPCWSTR

Penunjuk ke string Unicode yang dihentikan null yang mengidentifikasi daftar properti. Lihat IPropertySystem::GetPropertyDescriptionListFromString untuk informasi selengkapnya tentang format parameter ini.

[in] riid

Jenis: REFIID

Referensi ke ID antarmuka antarmuka yang diminta.

[out] ppv

Jenis: batal**

Ketika fungsi ini kembali, berisi pointer antarmuka yang diminta dalam riid. Ini biasanya IPropertyDescriptionList.

Nilai kembali

Jenis: PSSTDAPI

Mengembalikan salah satu nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Antarmuka diperoleh.
E_INVALIDARG	Parameter ppv adalah NULL.

Keterangan

Fungsi ini memanggil implementasi subsistem properti dari IPropertySystem::GetPropertyDescriptionListFromString untuk mendapatkan kumpulan properti yang disediakan sebagai string daftar properti yang dibatasi titik koma.

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 ditujukkan oleh nilai dalam ppv, yang menghilangkan kemungkinan kesalahan pengkodian.

Untuk informasi selengkapnya tentang skema properti, lihat Skema Properti.

Contoh

Contoh berikut, untuk disertakan sebagai bagian dari program yang lebih besar, menunjukkan cara menggunakan PSGetPropertyDescriptionListFromString.

IPropertyDescriptionList *pList;

HRESULT hr = PSGetPropertyDescriptionListFromString(L"prop:System.Title;System.Size",
                                                    IID_PPV_ARGS(&pList));
                                                    
if (SUCCEEDED(hr))
{
    // pList is now valid.
 
    pList->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 5.0 atau yang lebih baru)
Redistribusi	Windows Desktop Search (WDS) 3.0

Share via