Função SHDefExtractIconW (shlobj_core.h)

Fornece um manipulador padrão para extrair um ícone de um arquivo.

Sintaxe

SHSTDAPI SHDefExtractIconW(
  [in]            LPCWSTR pszIconFile,
                  int     iIndex,
  [in]            UINT    uFlags,
  [out, optional] HICON   *phiconLarge,
  [out, optional] HICON   *phiconSmall,
                  UINT    nIconSize
);

Parâmetros

[in] pszIconFile

Tipo: LPCTSTR

Um ponteiro para um buffer encerrado em nulo que contém o caminho e o nome do arquivo do qual o ícone é extraído.

iIndex

Tipo: int

O local do ícone dentro do arquivo chamado em pszIconFile. Se esse for um número positivo, ele se referirá à posição baseada em zero do ícone no arquivo. Por exemplo, 0 refere-se ao 1º ícone no arquivo de recurso e 2 refere-se ao terceiro. Se esse for um número negativo, ele se referirá à ID do recurso do ícone.

[in] uFlags

Tipo: UINT

Um sinalizador que controla a extração de ícones.

GIL_SIMULATEDOC

Sobrepõe o ícone extraído no ícone de documento padrão para criar o ícone final. Esse ícone pode ser usado quando nenhum ícone mais apropriado puder ser encontrado ou recuperado.

[out, optional] phiconLarge

Tipo: HICON*

Um ponteiro para um HICON que, quando essa função retorna com êxito, recebe o identificador da versão grande do ícone especificado no LOWORD de nIconSize. Esse valor pode ser NULL.

[out, optional] phiconSmall

Tipo: HICON*

Um ponteiro para um HICON que, quando essa função retorna com êxito, recebe o identificador da pequena versão do ícone especificado no HIWORD de nIconSize.

nIconSize

Tipo: UINT

Um valor que contém o tamanho do ícone grande em seu LOWORD e o tamanho do ícone pequeno em seu HIWORD. O tamanho é medido em pixels. Passe 0 para especificar tamanhos grandes e pequenos padrão.

Retornar valor

Tipo: HRESULT

Essa função pode retornar um desses valores.

Comentários

É responsabilidade do chamador liberar os recursos de ícone criados por meio dessa função quando eles não forem mais necessários. Isso pode ser feito por meio da função DestroyIcon .

Requisitos