Поделиться через

Метод IOpenControlPanel::GetPath (shobjidl_core.h)

  • Статья

Возвращает путь к указанному элементу панель управления.

Синтаксис

HRESULT GetPath(
  [in]  LPCWSTR pszName,
  [out] LPWSTR  pszPath,
  [in]  UINT    cchPath
);

Параметры

[in] pszName

Тип: LPCWSTR

Указатель на каноническое имя элемента или его GUID. Это значение может иметь значение NULL. Дополнительные сведения см. в разделе Примечания. Полный список канонических имен панель управления элементов см. в разделе Канонические имена элементов панель управления.

[out] pszPath

Тип: LPWSTR

При возврате этим методом содержит путь к указанному элементу панель управления в виде строки Юникода.

[in] cchPath

Тип: UINT

Размер буфера, на который указывает pszPath, в WCHAR.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Если pszName указывает на каноническое имя или GUID элемента, то возвращаемый путь находится в одной из двух форм в зависимости от последнего представления панель управления (классическое представление или представление категории):

::{CLSID_ControlPanel}\::{item guid}
::{CLSID_ControlPanelCategory}\categoryId\::{item guid}

Если pszName имеет значение NULL , возвращается одно из следующих двух значений:

::{CLSID_ControlPanel}
::{CLSID_ControlPanelCategory}

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header shobjidl_core.h (включая Shobjidl.h)

См. также раздел

Разработка для панель управления

IOpenControlPanel