Fonction SHRunControlPanel (shlobj.h)

Article
08/26/2023

Ouvre un élément Panneau de configuration.

Note Cette fonction n’est pas prise en charge à partir de Windows Vista

Syntaxe

BOOL SHRunControlPanel(
  [in]           PCWSTR lpcszCmdLine,
  [in, optional] HWND   hwndMsgParent
);

Paramètres

[in] lpcszCmdLine

Type : PCWSTR

Pointeur vers une chaîne qui contient la ligne de commande qui ouvre l’élément Panneau de configuration. Cette ligne de commande inclut au moins le nom du fichier .cpl. Il peut également contenir d’autres informations nécessaires telles que la page de feuille de propriétés dans l’élément (par ordinal ou par nom). Pour plus d’informations, consultez Exécution de Panneau de configuration éléments.

[in, optional] hwndMsgParent

Type : HWND

Handle de la fenêtre parente, utilisé pour afficher les messages d’erreur concernant l’ouverture de l’élément. Cette valeur peut être NULL.

Valeur retournée

Type : BOOL

TRUE si l’élément Panneau de configuration a été ouvert avec succès ; sinon, FALSE.

À partir de Windows Vista, cette fonction retourne toujours FALSE.

Remarques

Si l’élément Panneau de configuration spécifié est déjà en cours d’exécution, SHRunControlPanel tente de basculer vers ce instance plutôt que d’ouvrir une nouvelle instance.

Exemples

Des exemples d’appels à SHRunControlPanel sont présentés ici.

SHRunControlPanel(TEXT("timedate.cpl"), hwnd);
SHRunControlPanel(L"appwiz.cpl", NULL);
SHRunControlPanel(L"appwiz.cpl,2", NULL);
SHRunControlPanel("desk.cpl,Settings", hwnd

Configuration requise


Client minimal pris en charge	Windows XP avec SP1 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlobj.h
DLL	Shell32.dll

Partager via