PsLookupPropertyHandlerCLSID, fonction (propsys.h)

Obtient l’identificateur de classe (CLSID) d’un gestionnaire de propriétés de fichier inscrit par ordinateur.

Syntaxe

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

Paramètres

[in] pszFilePath

Type : PCWSTR

Pointeur vers une mémoire tampon Unicode terminée par un caractère Null qui contient le chemin absolu du fichier dont le CLSID du gestionnaire de propriétés est demandé.

[out] pclsid

Type : CLSID*

Lorsque cette fonction est retournée, contient le CLSID du gestionnaire de propriétés demandé.

Valeur retournée

Type : PSSTDAPI

Retourne S_OK en cas de réussite, ou une valeur d’erreur dans le cas contraire.

Notes

Pour plus d’informations sur l’inscription de votre gestionnaire, consultez Initialisation des gestionnaires de propriétés.

Cette fonction retourne uniquement les gestionnaires inscrits sous HKEY_LOCAL_MACHINE.

La plupart des applications appelantes ne doivent pas avoir besoin d’appeler cette méthode ou d’utiliser CoCreateInstance pour créer un gestionnaire de propriétés directement. Au lieu de cela, les applications appelantes doivent utiliser IShellItem2::GetPropertyStore pour créer un magasin de propriétés pour un élément Shell sur Windows Vista. IShellItem2::GetPropertyStore fournit le plus grand ensemble de propriétés disponibles pour un élément Shell, et le plus grand nombre d’options pour personnaliser exactement les propriétés à retourner.

Si aucun gestionnaire de propriétés n’est inscrit pour le fichier spécifié, cette fonction retourne un code d’erreur. Dans ce cas, il peut toujours être possible de lire certaines propriétés du système de fichiers à partir du magasin de propriétés retourné par IShellItem2::GetPropertyStore.

Les applications qui doivent créer un gestionnaire de propriétés à partir du code et qui doivent s’exécuter à la fois sur Windows Vista et sur Windows XP peuvent appeler PSGetItemPropertyHandler afin de créer un magasin de propriétés pour un élément Shell via le redistribuable Microsoft Windows Desktop Search (WDS).

Exemples

L’exemple suivant, à inclure dans le cadre d’un programme plus large, montre comment utiliser 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.
}

Spécifications

Voir aussi

IShellItem2::GetPropertyStore

PSGetItemPropertyHandler