Função SHCreatePropSheetExtArray (shlobj.h)

[SHCreatePropSheetExtArray está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]

Carrega todos os manipuladores de extensão da folha de propriedades do Shell localizados em uma chave do Registro especificada.

Sintaxe

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

Parâmetros

[in] hKey

Tipo: HKEY

A chave raiz do Registro que contém a subchave com os manipuladores de extensão da folha de propriedades. Por exemplo, HKEY_LOCAL_MACHINE.

[in, optional] pszSubKey

Tipo: PCWSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo especificando o nome da subchave que contémPropertySheetHandlersdo shellex\.

Por exemplo, se hkey especificar HKEY_LOCAL_MACHINE e pszSubkey especificar "Software\Microsoft\Windows\CurrentVersion\Controls Folder\Display", essa função retornará manipuladores de extensão da folha de propriedades usando a seguinte subchave:

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         Windows
            CurrentVersion
               Controls Folder
                  Display
                     shellex
                        PropertySheetHandlers

max_iface

Tipo: UINT

O número máximo de manipuladores de folha de propriedades a serem retornados.

Retornar valor

Tipo: HPSXA

Retorna um identificador para uma matriz de manipuladores de folha de propriedades. Passe esse valor para SHAddFromPropSheetExtArray. Você não acessa esse valor diretamente.

Comentários

Quando terminar de usar o identificador HPSXA retornado, destrua-o chamando SHDestroyPropSheetExtArray.

Essa função carrega até max_iface extensões de folha de propriedades em uma matriz que é então passada para SHAddFromPropSheetExtArray.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shlobj.h
Biblioteca	Shell32.lib
DLL	Shell32.dll (versão 5.0 ou posterior)