Share via

Функция 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 с пакетом обновления 1 (SP1) [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header shlobj.h
DLL Shell32.dll