ExtractAssociatedIcon

A função ExtractAssociatedIcon retorna um identificador para um ícone indexado encontrados em um arquivo ou um ícone encontrado em um arquivo executável associado.

(HICON ExtractAssociatedIcon HINSTANCE  hInst, / / identificador de instância de aplicativoLPTSTRlpIconPath, / / caminho e o nome do arquivo do arquivo para o qual ícone é / / wantedLPWORDlpiIcon / / ponteiro para o índice do ícone);
 

Parâmetros

hInst
Especifica a instância do aplicativo que chama a função.
lpIconPath
Ponteiro para uma Cadeia de caracteres que especifica o caminho completo e nome do arquivo do arquivo para o qual um ícone é desejado. A função extrai o identificador do ícone de arquivo ou de um arquivo executável associado com esse arquivo.

Se o identificador de ícone é obtido de um arquivo executável, a função armazena o caminho completo e nome do arquivo do executável que na seqüência de caracteres apontada pelo lpIconPath.

lpiIcon
Ponteiro para uma palavra que especifica o índice do ícone cujo identificador é para ser obtido.

Se o identificador de ícone é obtido de um arquivo executável, a função armazena o identificador do ícone na palavra apontada pelo lpiIcon.

Retornar valores

Se a função for bem-sucedido, o valor de retorno é um identificador de ícone. Se o ícone é extraído de um arquivo executável associado, a função armazena o caminho completo e nome do arquivo of the arquivo executável na seqüência de caracteres apontada pelo lpIconPathe armazena o identificador do ícone da palavra apontada pelo lpiIcon.

Se a função falhar, o valor de retorno é NULL.

Observações

A função ExtractAssociatedIcon procura primeiro o ícone indexado no arquivo especificado por lpIconPath. Se a função não é possível obter o identificador do ícone do arquivo e o arquivo possui um arquivo executável associado, ele procura no arquivo executável para um ícone. Associações com arquivos executáveis são baseadas em extensões de arquivo são armazenadas na parte por usuário do registro e podem ser definidas por meio do Gerenciador de arquivos associado comando.

QuickInfo

nbsp; Windows &NT: requer a versão 3.5 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, ExtractIcon

Index