Méthode IOpenControlPanel ::GetPath (shobjidl_core.h)
Obtient le chemin d’accès d’un élément Panneau de configuration spécifié.
Syntaxe
HRESULT GetPath(
[in] LPCWSTR pszName,
[out] LPWSTR pszPath,
[in] UINT cchPath
);
Paramètres
[in] pszName
Type : LPCWSTR
Pointeur vers le nom canonique de l’élément ou son GUID. Cette valeur peut être NULL. Pour plus d’informations, voir Notes. Pour obtenir la liste complète des noms canoniques d’éléments Panneau de configuration, consultez Noms canoniques des éléments Panneau de configuration.
[out] pszPath
Type : LPWSTR
Lorsque cette méthode est retournée, contient le chemin d’accès de l’élément Panneau de configuration spécifié sous forme de chaîne Unicode.
[in] cchPath
Type : UINT
Taille de la mémoire tampon pointée vers pszPath, dans WCHAR.
Valeur retournée
Type : HRESULT
Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Remarques
Si pszName pointe vers le nom canonique ou le GUID de l’élément, le chemin d’accès retourné se présente sous l’une de ces deux formes, en fonction de l’affichage Panneau de configuration le plus récent (affichage classique ou mode Catégorie) :
::{CLSID_ControlPanel}\::{item guid}
::{CLSID_ControlPanelCategory}\categoryId\::{item guid}
Si pszName a la valeur NULL , l’une de ces deux valeurs est retournée :
::{CLSID_ControlPanel}
::{CLSID_ControlPanelCategory}
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
Plateforme cible | Windows |
En-tête | shobjidl_core.h (incluez Shobjidl.h) |