Estrutura SHFILEINFOA (shellapi.h)

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 precisar mais dele.

iIcon

Tipo: int

O índice da imagem de ícone dentro da 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.

Observações

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

Nota

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. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

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