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

See also

IShellItem2::GetPropertyStore

PSGetItemPropertyHandler