SHCreatePropSheetExtArray 函数 (shlobj.h)

  • 项目

[SHCreatePropSheetExtArray 可用于“要求”部分中指定的操作系统。 它在后续版本中可能已更改或不可用。]

加载位于指定注册表项下的所有 Shell 属性表扩展处理程序 。

语法

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

参数

[in] hKey

类型： HKEY

包含具有属性表扩展处理程序的子项的注册表根项。 例如， HKEY_LOCAL_MACHINE。

[in, optional] pszSubKey

类型： PCWSTR

指向以 null 结尾的字符串的指针，该字符串指定包含 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 句柄后，通过调用 SHDestroyPropSheetExtArray 将其销毁。

此函数最多 将max_iface 属性表扩展加载到一个数组中，然后传递给 SHAddFromPropSheetExtArray。

要求

要求 值
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 shlobj.h
Library Shell32.lib
DLL Shell32.dll (5.0 或更高版本)