SHRunControlPanel-Funktion (shlobj.h)

Artikel
08/26/2023

Öffnet ein Systemsteuerung-Element.

Hinweis Diese Funktion wird ab Windows Vista nicht unterstützt.

Syntax

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

Parameter

[in] lpcszCmdLine

Typ: PCWSTR

Zeiger auf eine Zeichenfolge, die die Befehlszeile enthält, die das Systemsteuerung-Element öffnet. Diese Befehlszeile enthält mindestens den Namen der .cpl Datei. Es kann auch alle anderen erforderlichen Informationen enthalten, z. B. die Eigenschaftenblattseite innerhalb des Elements (entweder nach Ordnung oder nach Name). Weitere Informationen finden Sie unter Ausführen Systemsteuerung Elemente.

[in, optional] hwndMsgParent

Typ: HWND

Das Handle des übergeordneten Fensters, das verwendet wird, um Fehlermeldungen zum Öffnen des Elements anzuzeigen. Dieser Wert kann NULL sein.

Rückgabewert

Typ: BOOL

TRUE, wenn das Systemsteuerung Element erfolgreich geöffnet wurde, andernfalls FALSE.

Ab Windows Vista gibt diese Funktion immer FALSE zurück.

Hinweise

Wenn das angegebene Systemsteuerung Element bereits ausgeführt wird, versucht SHRunControlPanel, zu diesem instance zu wechseln, anstatt eine neue instance zu öffnen.

Beispiele

Hier werden Beispielaufrufe für SHRunControlPanel gezeigt.

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

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP mit SP1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlobj.h
DLL	Shell32.dll