ExtractIconEx

9/9/2008

Essa função recupera ícone alças do especificado arquivo executável ou dynamic-link library (DLL).

Syntax

HICON ExtractIconEx(
  LPCTSTR lpszFile, 
  int nIconIndex,
  HICON FAR* phiconLarge,
  HICON FAR* phiconSmall,
  UINT nIcons
);

Parameters

• lpszFile
  [no] Ponteiro longo para um seqüência de caracteres NULL-Terminated que especifica o nome de uma arquivo executável ou DLL arquivo a partir da qual extrair ícones.

• nIconIndex
  [no] Especifica a índice com base zero do primeiro ícone para extrair. De exemplo, se esse valor é zero, a função extrai o primeiro ícone no arquivo especificado.

  Windows CE 2.10 e posterior, o nIconIndex parâmetro deve ser zero ou –N, onde N é um identificador recurso especificado. O nIcons parâmetro deve ser 1.

  Para Windows CE 1.0 através de 2.10, a função retorna o número total de ícones no arquivo especificado se nIconIndex é – 1 e phIconLarge e phiconSmall são NULL. Se o arquivo for um arquivo executável ou DLL, o valor de retorno é o número de recursos RT_GROUP_ICON. Se o arquivo for um arquivo .ico, o valor de retorno é 1.

• phiconLarge
  [in, Out] Ponteiro para uma matriz para receber alças para ícones grandes extraídos do arquivo. Se este parâmetro é NULL, não ícones grandes são extraídos a partir de arquivo.

• phiconSmall
  [in, Out] Ponteiro para uma matriz para receber alças para ícones pequenos extraídos do arquivo. Se este parâmetro é NULL, não ícones pequenos são extraídos a partir de arquivo.

• nIcons
  [no] Especifica o número dos ícones para extrair a partir de arquivo. Windows CE 2.10 e posterior, o nIcons parâmetro deve ser 1.

Return Value

Windows CE 2.10 e posterior, essa função retorna o identificador para o primeiro ícone na matriz de ícone recuperados. Se os dois phiconLarge e phiconSmall Não são NULL, o valor de retorno padrão é o primeiro ícone grande.

Windows CE 1.0 através de 2.10, essa função retorna um UINT tipo de dados. Se a pasta nIconIndex parâmetro é – 1, o phiconLarge parâmetro é NULL e o phiconSmall parâmetro é NULL, o valor de retorno é o número dos ícones contidos o arquivo especificado. Caso contrário, o valor de retorno é o número dos ícones extraídos com êxito a partir de arquivo.

Remarks

Seu aplicativo deve destruir todos os ícones extraídos por essa função, chamado de DestroyIcon função de cada ícone. Observe que destruição de todos os ícones de matriz recuperado destrói também o ícone retornado.

Para recuperar as dimensões dos ícones grandes e pequenos, use o GetSystemMetrics função com os sinalizadores SM_CXICON, SM_CYICON, SM_CXSMICON e SM_CYSMICON.

Requirements

Header	shellapi.h
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

DestroyIcon
GetSystemMetrics