Функция SHRunControlPanel (shlobj.h)

Открывает элемент панель управления.

Синтаксис

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

Требования