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
程式庫	Shell32.lib
Dll	Shell32.dll (5.0 版或更新版本)