Função ExtractAssociatedIconA (shellapi.h)

Obtém um identificador para um ícone armazenado como um recurso em um arquivo ou um ícone armazenado no arquivo executável associado a um arquivo.

Sintaxe

HICON ExtractAssociatedIconA(
  [in]      HINSTANCE hInst,
  [in, out] LPSTR     pszIconPath,
  [in, out] WORD      *piIcon
);

Parâmetros

[in] hInst

Tipo: HINSTANCE

Um identificador para a instância do aplicativo de chamada.

[in, out] pszIconPath

Tipo: LPTSTR

Ponteiro para uma cadeia de caracteres que, na entrada, especifica o caminho completo e o nome do arquivo que contém o ícone. A função extrai o identificador de ícone desse arquivo ou de um arquivo executável associado a esse arquivo.

Quando essa função retorna, se o identificador de ícone foi obtido de um arquivo executável (um arquivo executável apontado por lpIconPath ou um arquivo executável associado), a função armazena o caminho completo e o nome do arquivo desse executável no buffer apontado por esse parâmetro.

[in, out] piIcon

Tipo: LPWORD

Ponteiro para um valor WORD que, na entrada, especifica o índice do ícone cujo identificador deve ser obtido.

Quando a função retorna, se o identificador de ícone foi obtido de um arquivo executável (um arquivo executável apontado por lpIconPath ou um arquivo executável associado), esse valor aponta para o índice do ícone nesse arquivo.

Retornar valor

Tipo: HICON

Se a função for bem-sucedida, o valor retornado será um identificador de ícone. Se o ícone for extraído de um arquivo executável associado, a função armazenará o caminho completo e o nome do arquivo executável na cadeia de caracteres apontada por lpIconPath e armazenará o identificador do ícone no WORD apontado por lpiIcon.

Se a função falhar, o valor retornado será NULL.

Comentários

Quando não for mais necessário, o chamador será responsável por liberar o identificador de ícone retornado por ExtractAssociatedIcon chamando a função DestroyIcon .

A função ExtractAssociatedIcon procura primeiro o ícone indexado no arquivo especificado por lpIconPath. Se a função não puder obter o identificador de ícone desse arquivo e o arquivo tiver um arquivo executável associado, ele procurará nesse arquivo executável um ícone. As associações com arquivos executáveis são baseadas em extensões de nome de arquivo e são armazenadas na parte por usuário do registro.

Requisitos

Confira também

ExtractAssociatedIconEx

ExtractIcon

ExtractIconEx