PSLookupPropertyHandlerCLSID function (propsys.h)
Gets the class identifier (CLSID) of a per-computer, registered file property handler.
Syntax
PSSTDAPI PSLookupPropertyHandlerCLSID(
[in] PCWSTR pszFilePath,
[out] CLSID *pclsid
);
Parameters
[in] pszFilePath
Type: PCWSTR
Pointer to a null-terminated, Unicode buffer that contains the absolute path of the file whose property handler CLSID is requested.
[out] pclsid
Type: CLSID*
When this function returns, contains the requested property handler CLSID.
Return value
Type: PSSTDAPI
Returns S_OK if successful, or an error value otherwise.
Remarks
For information on how to register your handler, see Initializing Property Handlers.
This function returns only those handlers registered under HKEY_LOCAL_MACHINE.
Most calling applications should not need to call this method or use CoCreateInstance to create a property handler directly. Instead, calling applications should use IShellItem2::GetPropertyStore to create a property store for a Shell item on Windows Vista. IShellItem2::GetPropertyStore provides the largest set of available properties for a Shell item, and the most options for customizing exactly which properties to return.
If no property handler is registered for the specified file, this function returns an error code. When this happens, it might still be possible to read certain file system properties from the property store returned from IShellItem2::GetPropertyStore.
Applications that need to create a property handler from code and that must run both on Windows Vista and on Windows XP can call PSGetItemPropertyHandler to create a property store for a Shell item through the Microsoft Windows Desktop Search (WDS) redistributable.
Examples
The following example, to be included as part of a larger program, demonstrates how to use 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.
}
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP with SP2, Windows Vista [desktop apps only] |
| Minimum supported server | Windows Server 2003 with SP1 [desktop apps only] |
| Target Platform | Windows |
| Header | propsys.h |
| Library | Propsys.lib |
| DLL | Propsys.dll (version 6.0 or later) |
| Redistributable | Windows Desktop Search (WDS) 3.0 |