Fonction SHRunControlPanel (shlobj.h)

Ouvre un élément Panneau de configuration.

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