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

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

  • Статья

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

Загружает все обработчики расширений страниц свойств оболочки , расположенные в указанном разделе реестра.

Синтаксис

HPSXA SHCreatePropSheetExtArray(
  [in]           HKEY   hKey,
  [in, optional] PCWSTR pszSubKey,
                 UINT   max_iface
);

Параметры

[in] hKey

Тип: HKEY

Корневой раздел реестра, содержащий подраздел с обработчиками расширений страниц свойств. Например, HKEY_LOCAL_MACHINE.

[in, optional] pszSubKey

Тип: PCWSTR

Указатель на строку, завершающуюся нулевым значением, задающую имя подраздела, содержащего shellex\PropertySheetHandlers.

Например, если hkey указывает HKEY_LOCAL_MACHINE, а pszSubkey указывает "Software\Microsoft\Windows\CurrentVersion\Controls Folder\Display", эта функция возвращает обработчики расширений страниц свойств с помощью следующего подраздела:

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         Windows
            CurrentVersion
               Controls Folder
                  Display
                     shellex
                        PropertySheetHandlers

max_iface

Тип: UINT

Максимальное число возвращаемых обработчиков страниц свойств.

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

Тип: HPSXA

Возвращает дескриптор массива обработчиков страниц свойств. Передайте это значение в SHAddFromPropSheetExtArray. Вы не можете получить доступ к этому значению напрямую.

Комментарии

Завершив работу с возвращенным дескриптором HPSXA, уничтожьте его, вызвав SHDesheetPropSheetExtArray.

Эта функция загружает до max_iface расширений страниц свойств в массив, который затем передается в SHAddFromPropSheetExtArray.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header shlobj.h
Библиотека Shell32.lib
DLL Shell32.dll (версия 5.0 или более поздняя)