Fonction SHCreatePropSheetExtArray (shlobj.h)

Article
03/06/2024

[SHCreatePropSheetExtArray est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions suivantes.]

Charge tous les gestionnaires d’extension de feuille de propriétés Shell situés sous une clé de Registre spécifiée.

Syntaxe

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

Paramètres

[in] hKey

Type : HKEY

Clé racine du Registre qui contient la sous-clé avec les gestionnaires d’extension de la feuille de propriétés. Pour instance, HKEY_LOCAL_MACHINE.

[in, optional] pszSubKey

Type : PCWSTR

Pointeur vers une chaîne terminée par null spécifiant le nom de la sous-clé qui contient shellex\PropertySheetHandlers.

Par exemple, si hkey spécifie HKEY_LOCAL_MACHINE et pszSubkey spécifie « Software\Microsoft\Windows\CurrentVersion\Controls Folder\Display », cette fonction retourne les gestionnaires d’extension de feuille de propriétés à l’aide de la sous-clé suivante :

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         Windows
            CurrentVersion
               Controls Folder
                  Display
                     shellex
                        PropertySheetHandlers

max_iface

Type : UINT

Nombre maximal de gestionnaires de feuille de propriétés à retourner.

Valeur retournée

Type : HPSXA

Retourne un handle à un tableau de gestionnaires de feuille de propriétés. Transmettez cette valeur à SHAddFromPropSheetExtArray. Vous n’accédez pas directement à cette valeur.

Remarques

Lorsque vous avez terminé avec le handle HPSXA retourné, détruisez-le en appelant SHDestroyPropSheetExtArray.

Cette fonction charge jusqu’à max_iface extensions de feuille de propriétés dans un tableau qui est ensuite passé à SHAddFromPropSheetExtArray.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlobj.h
Bibliothèque	Shell32.lib
DLL	Shell32.dll (version 5.0 ou ultérieure)

Partager via