Bagikan melalui


Fungsi PSGetPropertyDescriptionListFromString (propsys.h)

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