Função SHExtractIconsW

Cria uma matriz de identificadores para ícones extraídos de um arquivo especificado.

Observação

Esta função está disponível no Windows XP Service Pack 2 (SP2). Ela pode estar indisponível ou ter sido alterada em versões subsequentes. Em vez disso, use a função SHDefExtractIcon.

Sintaxe

UINT SHExtractIconsW(
  _In_  LPCWSTR pszFileName,
  _In_  int     nIconIndex,
  _In_  int     cxIcon,
  _In_  int     cyIcon,
  _Out_ HICON   *phIcon,
  _Out_ UINT    *pIconId,
  _In_  UINT    nIcons,
  _In_  UINT    flags
);

Parâmetros

pszFileName [in]

Tipo: LPCWSTR

Um ponteiro para o nome do arquivo de onde os ícones devem ser extraídos.

nIconIndex [in]

Digite: int

O índice do primeiro ícone a ser extraído do recurso nomeado em pszFileName.

cxIcon [in]

Digite: int

A largura desejada do ícone. Consulte Observações.

cyIcon [in]

Digite: int

A altura desejada do ícone. Consulte Observações.

phIcon [out]

Tipo: HICON*

Quando essa função retorna, contém um ponteiro para a matriz de identificadores de ícone.

pIconId [out]

Digite: UINT*

Quando essa função retorna, contém um ponteiro para o identificador de recurso do ícone extraído que melhor se ajusta ao dispositivo de vídeo atual. Se não houver um identificador disponível para esse formato, ele conterá 0xFFFFFFFF. Se nenhum identificador puder ser obtido por qualquer outro motivo, ele retornará zero.

nIcons [in]

Tipo: UINT

O número de ícones a serem extraídos do recurso nomeado em pszFileName. Esse parâmetro é válido somente quando o recurso é um arquivo .exe ou .dll.

sinalizadores [in]

Tipo: UINT

Os sinalizadores que controlam essa função. Para obter valores possíveis, consulte o parâmetro fuLoad da funçãoLoadImage.

Valor retornado

Tipo: UINT

Um valor diferente de zero, se bem-sucedido; caso contrário, zero.

Comentários

SHExtractIconsW extrai dos seguintes tipos de arquivo.

• Executável (.exe)
• DLL (.dll)
• Icon (.ico)
• Cursor (.cur)
• Cursor animado (.ani)
• Bitmap (.bpm)

Extrações de arquivos executáveis de 16 bits do Windows 3.x (.exe ou .dll) também têm suporte.

Os parâmetros cxIcon e cyIcon especificam o tamanho dos ícones a serem extraídos. Dois tamanhos podem ser extraídos através de cada parâmetro, dividindo o valor entre seu LOWORD e HIWORD. Coloque o primeiro tamanho desejado no LOWORD do parâmetro e o segundo tamanho no HIWORD. Por exemplo, MAKELONG(24, 48) para cxIcon e cyIcon extrai ícones de tamanho 24 e 48.

O processo de chamada é responsável por destruir todos os ícones extraídos através desta função, chamando a função DestroyIcon.

SHExtractIconsW não é exportado por nome ou declarado em um arquivo de cabeçalho público. Para usá-lo, você deve declarar um protótipo correspondente e usar GetProcAddress para solicitar um ponteiro de função do Shell32.dll que pode ser usado para chamar essa função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional, Windows XP [somente aplicativos de desktop]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
DLL	Shell32.dll (versão 5.0 ou posterior)
Nomes Unicode e ANSI	SHExtractIconsW (Unicode)