shRunControlPanel 函数 (shlobj.h)

  • 项目

打开控制面板项。

注意 从 Windows Vista 开始不支持此函数
 

语法

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

参数

[in] lpcszCmdLine

类型： PCWSTR

指向包含打开控制面板项的命令行的字符串的指针。 此命令行至少包含 .cpl 文件的名称。 它还可以包含任何其他必要信息，例如项 (按序号或名称) 的属性表页。 有关详细信息，请参阅执行控制面板项。

[in, optional] hwndMsgParent

类型：HWND

父窗口的句柄，用于显示有关项打开的错误消息。 此值可以为 NULL。

返回值

类型： BOOL

如果成功打开控制面板项，则为 TRUE;否则为 FALSE。

从 Windows Vista 起，此函数始终返回 FALSE。

注解

如果指定的控制面板项已在运行，SHRunControlPanel 将尝试切换到该实例，而不是打开一个新实例。

示例

此处显示了对 SHRunControlPanel 的示例调用。

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

要求

   
最低受支持的客户端 Windows XP SP1 [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 shlobj.h
DLL Shell32.dll