Compartir a través de

Función SHCreatePropSheetExtArray (shlobj.h)

  • Artículo

[SHCreatePropSheetExtArray está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores.

Carga todos los controladores de extensión de hoja de propiedades de Shell ubicados en una clave del Registro especificada.

Sintaxis

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

Parámetros

[in] hKey

Tipo: HKEY

Clave raíz del Registro que contiene la subclave con los controladores de extensión de hoja de propiedades. Por ejemplo, HKEY_LOCAL_MACHINE.

[in, optional] pszSubKey

Tipo: PCWSTR

Puntero a una cadena terminada en null que especifica el nombre de la subclave que contiene shellex\PropertySheetHandlers.

Por ejemplo, si hkey especifica HKEY_LOCAL_MACHINE y pszSubkey especifica "Software\Microsoft\Windows\CurrentVersion\Controls Folder\Display", esta función devuelve controladores de extensión de hoja de propiedades mediante la siguiente subclave:

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         Windows
            CurrentVersion
               Controls Folder
                  Display
                     shellex
                        PropertySheetHandlers

max_iface

Tipo: UINT

Número máximo de controladores de hoja de propiedades que se van a devolver.

Valor devuelto

Tipo: HPSXA

Devuelve un identificador a una matriz de controladores de hoja de propiedades. Pase este valor a SHAddFromPropSheetExtArray. No tiene acceso a este valor directamente.

Comentarios

Cuando haya terminado con el identificador HPSXA devuelto, destruya mediante una llamada a SHDestroyPropSheetExtArray.

Esta función carga hasta max_iface extensiones de hoja de propiedades en una matriz que luego se pasa a SHAddFromPropSheetExtArray.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shlobj.h
Library Shell32.lib
Archivo DLL Shell32.dll (versión 5.0 o posterior)