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

Статья
11/20/2024

[SHOpenPropSheet доступен для использования в операционных системах, указанных в разделе "Требования". Он может быть изменен или недоступен в последующих версиях.]

Создает лист свойств из списка разделов реестра, содержащих CLSIDотдельных листов, а затем открывает лист свойств.

Синтаксис

BOOL SHOpenPropSheetW(
  [in, optional] LPCWSTR       pszCaption,
  [in, optional] HKEY []       ahkeys,
                 UINT          ckeys,
  [in, optional] const CLSID   *pclsidDefault,
  [in]           IDataObject   *pdtobj,
  [in, optional] IShellBrowser *psb,
  [in, optional] LPCWSTR       pStartPage
);

Параметры

[in, optional] pszCaption

Тип: LPCTSTR

Указатель на строку, содержащую подпись для листа свойств. Это значение может быть значение NULL если подпись не требуется.

[in, optional] ahkeys

Тип: HKEY[]

Массив разделов реестра, представляющих CLSIDотдельных листов свойств.

ckeys

Тип: UINT

значение UINT, указывающее количество листов свойств в массиве, указанного ahkeys.

[in, optional] pclsidDefault

Тип: const CLSID*

Указатель на CLSID по умолчанию. Это значение может быть NULL.

[in] pdtobj

Тип: IDataObject*

Указатель на IDataObject— объект OLE, который можно использовать для выполнения действий на листах свойств.

[in, optional] psb

Тип: IShellBrowser*

Не используется.

[in, optional] pStartPage

Тип: LPCTSTR

Указатель на строку, указывающую начальную страницу. Это значение может быть NULL.

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

Тип: BOOL

Возвращает TRUE, если лист свойств успешно создан; в противном случае FALSE.

Замечания

Заметка

Заголовок shlobj.h определяет SHOpenPropSheet как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	shlobj.h
библиотеки	Shell32.lib
DLL	Shell32.dll (версия 5.0 или более поздняя версия)

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