ExtractIcon

A função ExtractIcon recupera um identificador para um ícone do arquivo executável especificado, biblioteca de vínculo dinâmico (DLL) ou arquivo de ícone.

Para recuperar uma matriz de identificadores para ícones grandes ou pequenos, use a função ExtractIconEx.

(HICON ExtractIcon HINSTANCE  hInst, / / instância alçaLPCTSTRlpszExeFileName, / / nome do arquivo com o ícone deUINTnIconIndex / / índice do ícone para extrair);
 

Parâmetros

hInst
Identificador para a instância do aplicativo que chama a função.
lpszExeFileName
Ponteiro para uma seqüência de caracteres null-terminated especificando o nome de um arquivo executável, DLL ou arquivo de ícone.
nIconIndex
Especifica o índice baseado em zero do ícone para recuperar. Por exemplo, se esse valor for 0, a função retorna um identificador para o primeiro ícone no arquivo especificado.

Se esse valor é – 1, a função retorna o número total de ícones no arquivo especificado. 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 é um.Arquivo ICO, o valor de retorno é 1.

Windows 95, Windows NT 4.0 e posterior: Se esse valor é um número negativo diferente de -1, a função retorna um identificador para o ícone no arquivo especificado é igual ao valor absoluto da nIconIndexcujo identificador de recurso. Por exemplo, use -3 para extrair o ícone cujo identificador de recurso é 3. Para extrair o ícone cujo identificador de recurso é 1, use a função ExtractIconEx.

Retornar valores

O valor de retorno é um identificador para um ícone. Se o arquivo especificado não era um arquivo executável, DLL ou arquivo de ícone, o retorno é 1. Se nenhum dos ícones foram encontrados no arquivo, o valor de retorno é NULL.

Observações

Você deve destruir o identificador de ícone retornado por ExtractIcon chamando o DestroyIcon função.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Sem suporte.
Cabeçalho:Declarado em shellapi.
Biblioteca de importação:Use shell32.lib.
Unicode:Implementado como versões Unicode e ANSI no Windows NT.

Ver também

Visão geral de ícones, ícone funções, DestroyIcon, ExtractIconEx

Index