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
| Client minimal pris en charge | Windows XP avec SP2, Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 avec SP1 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | propsys.h |
| Bibliothèque | Propsys.lib |
| DLL | Propsys.dll (version 6.0 ou ultérieure) |
| Composant redistribuable | Windows Desktop Search (WDS) 3.0 |