Fungsi PSLookupPropertyHandlerCLSID (propsys.h)

Mendapatkan pengidentifikasi kelas (CLSID) dari handler properti file yang terdaftar per komputer.

Sintaks

PSSTDAPI PSLookupPropertyHandlerCLSID(
  [in]  PCWSTR pszFilePath,
  [out] CLSID  *pclsid
);

Parameter

[in] pszFilePath

Jenis: PCWSTR

Penunjuk ke buffer Unicode yang dihentikan null yang berisi jalur absolut file yang penangan propertinya CLSID diminta.

[out] pclsid

Jenis: CLSID*

Ketika fungsi ini kembali, berisi handler properti yang diminta CLSID.

Menampilkan nilai

Jenis: PSSTDAPI

Mengembalikan S_OK jika berhasil, atau nilai kesalahan sebaliknya.

Keterangan

Untuk informasi tentang cara mendaftarkan handler Anda, lihat Menginisialisasi Penangan Properti.

Fungsi ini hanya mengembalikan handler yang terdaftar di bawah HKEY_LOCAL_MACHINE.

Sebagian besar aplikasi panggilan tidak perlu memanggil metode ini atau menggunakan CoCreateInstance untuk membuat handler properti secara langsung. Sebagai gantinya, aplikasi panggilan harus menggunakan IShellItem2::GetPropertyStore untuk membuat penyimpanan properti untuk item Shell di Windows Vista. IShellItem2::GetPropertyStore menyediakan sekumpulan properti terbesar yang tersedia untuk item Shell, dan opsi terbanyak untuk menyesuaikan properti mana yang akan dikembalikan.

Jika tidak ada handler properti yang terdaftar untuk file yang ditentukan, fungsi ini mengembalikan kode kesalahan. Ketika ini terjadi, mungkin masih mungkin untuk membaca properti sistem file tertentu dari penyimpanan properti yang dikembalikan dari IShellItem2::GetPropertyStore.

Aplikasi yang perlu membuat handler properti dari kode dan yang harus berjalan baik di Windows Vista maupun di Windows XP dapat memanggil PSGetItemPropertyHandler untuk membuat penyimpanan properti untuk item Shell melalui Microsoft Windows Desktop Search (WDS) yang dapat didistribusikan ulang.

Contoh

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

CLSID clsid;

HRESULT hr = PSLookupPropertyHandlerCLSID(L"C:\\windows\\system32\\shell32.dll", &clsid);

if (SUCCEEDED(hr))
{
    // clsid contains the CLSID of the property handler used for 
    // C:\windows\system32\shell32.dll.
}

Persyaratan

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

IShellItem2::GetPropertyStore

PSGetItemPropertyHandler