Funzione SHRunControlPanel (shlobj.h)

Articolo
03/15/2023

Apre un elemento Pannello di controllo.

Nota Questa funzione non è supportata a partire da Windows Vista

Sintassi

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

Parametri

[in] lpcszCmdLine

Tipo: PCWSTR

Puntatore a una stringa contenente la riga di comando che apre l'elemento Pannello di controllo. Questa riga di comando include almeno il nome del file .cpl. Può anche contenere altre informazioni necessarie, ad esempio la pagina della finestra delle proprietà all'interno dell'elemento (ordinale o per nome). Per altre informazioni, vedere Esecuzione di elementi Pannello di controllo.

[in, optional] hwndMsgParent

Tipo: HWND

Handle della finestra padre, utilizzato per visualizzare i messaggi di errore relativi all'apertura dell'elemento. Questo valore può essere NULL.

Valore restituito

Tipo: BOOL

TRUE se l'elemento Pannello di controllo è stato aperto correttamente; in caso contrario, FALSE.

A partire da Windows Vista, questa funzione restituisce sempre FALSE.

Commenti

Se l'elemento Pannello di controllo specificato è già in esecuzione, SHRunControlPanel tenta di passare a tale istanza anziché aprire una nuova istanza.

Esempio

Di seguito sono riportate le chiamate di esempio a SHRunControlPanel .

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

Requisiti


Client minimo supportato	Windows XP con SP1 [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlobj.h
DLL	Shell32.dll

Condividi tramite