Partager via


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)

Voir aussi

Développement pour le Panneau de configuration

IOpenControlPanel