Estrutura SHFILEINFOA (shellapi.h)

  • Artigo

Contém informações sobre um objeto de arquivo.

Sintaxe

typedef struct _SHFILEINFOA {
  HICON hIcon;
  int   iIcon;
  DWORD dwAttributes;
  CHAR  szDisplayName[MAX_PATH];
  CHAR  szTypeName[80];
} SHFILEINFOA;

Membros

hIcon

Tipo: HICON

Um identificador para o ícone que representa o arquivo. Você é responsável por destruir esse identificador com DestroyIcon quando não precisa mais dele.

iIcon

Tipo: int

O índice da imagem de ícone na lista de imagens do sistema.

dwAttributes

Tipo: DWORD

Uma matriz de valores que indica os atributos do objeto de arquivo. Para obter informações sobre esses valores, consulte o método IShellFolder::GetAttributesOf .

szDisplayName[MAX_PATH]

Tipo: TCHAR[MAX_PATH]

Uma cadeia de caracteres que contém o nome do arquivo como ele aparece no Shell do Windows ou o caminho e o nome do arquivo que contém o ícone que representa o arquivo.

szTypeName[80]

Tipo: TCHAR[80]

Uma cadeia de caracteres que descreve o tipo de arquivo.

Comentários

Essa estrutura é usada com a função SHGetFileInfo .

Observação

O cabeçalho shellapi.h define SHFILEINFO como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho shellapi.h