Função ExtractIconA (shellapi.h)

Obtém um identificador para um ícone do arquivo executável, DLL ou arquivo de ícone especificado.

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

Sintaxe

HICON ExtractIconA(
  [in] HINSTANCE hInst,
  [in] LPCSTR    pszExeFileName,
       UINT      nIconIndex
);

Parâmetros

[in] hInst

Tipo: HINSTANCE

Manipule para a instância do aplicativo que chama a função.

[in] pszExeFileName

Tipo: LPCTSTR

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome de um arquivo executável, DLL ou arquivo de ícone.

nIconIndex

Tipo: UINT

Especifica o índice baseado em zero do ícone a ser recuperado. Por exemplo, se esse valor for 0, a função retornará um identificador para o primeiro ícone no arquivo especificado.

Se esse valor for -1, a função retornará o número total de ícones no arquivo especificado. Se o arquivo for um arquivo executável ou DLL, o valor retornado será o número de recursos RT_GROUP_ICON. Se o arquivo for um . Arquivo ICO, o valor retornado é 1.

Se esse valor for um número negativo não igual a –1, a função retornará um identificador para o ícone no arquivo especificado cujo identificador de recurso é igual ao valor absoluto de nIconIndex. Por exemplo, você deve usar –3 para extrair o ícone cujo identificador de recurso é 3. Para extrair o ícone cujo identificador de recurso é 1, use a função ExtractIconEx.

Valor de retorno

Tipo: HICON

O valor retornado é um identificador para um ícone. Se o arquivo especificado não for um arquivo executável, DLL ou arquivo de ícone, o retorno será 1. Se nenhum ícone tiver sido encontrado no arquivo, o valor retornado será NULL.

Observações

Quando ele não for mais necessário, você deve destruir o identificador de ícone retornado por ExtractIcon chamando a função DestroyIcon .

Requisitos

Consulte também

ExtractAssociatedIcon

ExtractAssociatedIconEx

ExtractIconEx