Função SHCreateFileExtractIconW (shlobj_core.h)

  • Artigo

[SHCreateFileExtractIcon está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]

Cria um manipulador IExtractIcon padrão para um objeto do sistema de arquivos. Extensões de namespace que exibem objetos do sistema de arquivos normalmente usam essa função. A extensão e os atributos de arquivo derivam tudo o que é necessário para um extrator de ícone simples.

Sintaxe

SHSTDAPI SHCreateFileExtractIconW(
  [in] LPCWSTR pszFile,
  [in] DWORD   dwFileAttributes,
  [in] REFIID  riid,
       void    **ppv
);

Parâmetros

[in] pszFile

Tipo: LPCTSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o objeto do sistema de arquivos. O buffer não deve exceder MAX_PATH caracteres de comprimento.

[in] dwFileAttributes

Tipo: DWORD

Uma combinação de um ou mais sinalizadores de atributo de arquivo (valores FILE_ATTRIBUTE_*, conforme definido em Winnt.h) que especificam o tipo de objeto.

[in] riid

Tipo: REFIID

Referência à ID de interface desejada da interface do extrator de ícone a ser criada. Isso deve ser IID_IExtractIconA ou IID_IExtractIconW.

ppv

Tipo: void**

Quando essa função retorna, contém o ponteiro de interface solicitado em riid. Normalmente, isso é IExtractIcon.

Retornar valor

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shlobj_core.h (inclua Shlobj.h)
Biblioteca Shell32.lib
DLL Shell32.dll (versão 5.0 ou posterior)