Funzione SHCreatePropSheetExtArray (shlobj.h)

[SHCreatePropSheetExtArray è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Potrebbe essere modificato o non disponibile nelle versioni successive.]

Carica tutti i gestori di estensione della finestra delle proprietà shell che si trovano in una chiave del Registro di sistema specificata.

Sintassi

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

Parametri

[in] hKey

Tipo: HKEY

Chiave radice del Registro di sistema che contiene la sottochiave con i gestori di estensione della finestra delle proprietà. Ad esempio, HKEY_LOCAL_MACHINE.

[in, optional] pszSubKey

Tipo: PCWSTR

Puntatore a una stringa con terminazione Null che specifica il nome della sottochiave contenente shellex\PropertySheetHandlers.

Ad esempio, se hkey specifica HKEY_LOCAL_MACHINE e pszSubkey specifica "Software\Microsoft\Windows\CurrentVersion\Controls Folder\Display", questa funzione restituisce i gestori di estensione della finestra delle proprietà usando la sottochiave seguente:

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         Windows
            CurrentVersion
               Controls Folder
                  Display
                     shellex
                        PropertySheetHandlers

max_iface

Tipo: UINT

Numero massimo di gestori della finestra delle proprietà da restituire.

Valore restituito

Tipo: HPSXA

Restituisce un handle a una matrice di gestori della finestra delle proprietà. Passare questo valore a SHAddFromPropSheetExtArray. Non si accede direttamente a questo valore.

Commenti

Al termine dell'handle HPSXA restituito, eliminarlo chiamando SHDestroyPropSheetExtArray.

Questa funzione carica fino a max_iface estensioni della finestra delle proprietà in una matrice che viene quindi passata a SHAddFromPropSheetExtArray.

Requisiti