Estrutura SHCOLUMNDATA (shlobj.h)

Artigo
03/13/2023

Contém informações que identificam um arquivo específico. Ele é usado por IColumnProvider::GetItemData ao solicitar dados para um arquivo específico.

Sintaxe

typedef struct {
  ULONG dwFlags;
  DWORD dwFileAttributes;
  ULONG dwReserved;
  WCHAR *pwszExt;
  WCHAR wszFile[MAX_PATH];
} SHCOLUMNDATA, *LPSHCOLUMNDATA;

Membros

dwFlags

Tipo: ULONG

Sinalizadores usados para especificar a natureza da solicitação.

SHCDF_UPDATEITEM

O arquivo especificado por wszFile é um novo arquivo ou um arquivo que foi alterado desde a última chamada para IColumnProvider::GetItemData. Todos os dados armazenados em cache devem ser liberados e recalculados. Manipuladores de coluna que não armazenam dados em cache ou que exibem dados armazenados separadamente do arquivo podem ignorar esse sinalizador.

dwFileAttributes

Tipo: DWORD

Sinalizadores de atributo de arquivo. Será um ou mais dos valores a seguir.

FILE_ATTRIBUTE_ARCHIVE

O arquivo ou diretório é um arquivo morto ou diretório. Os aplicativos usam esse atributo para marcar arquivos para backup ou remoção.

FILE_ATTRIBUTE_COMPRESSED

O arquivo ou diretório está compactado. Para um arquivo, isso significa que todos os dados no arquivo são compactados. Para um diretório, isso significa que a compactação é o padrão para arquivos e subdiretórios que acabam de ser criados.

FILE_ATTRIBUTE_DIRECTORY

O identificador identifica um diretório.

FILE_ATTRIBUTE_ENCRYPTED

O arquivo ou diretório está criptografado. Para um arquivo, isso significa que todos os fluxos de dados no arquivo são criptografados. Para um diretório, isso significa que a criptografia é o padrão para arquivos e subdiretórios recém-criados.

FILE_ATTRIBUTE_HIDDEN

O arquivo ou diretório está oculto. Ele não está incluído em uma listagem de diretórios comuns.

FILE_ATTRIBUTE_NORMAL

O arquivo ou diretório não possui nenhum outro conjunto de atributos. Este atributo é válido apenas quando usado sozinho.

FILE_ATTRIBUTE_OFFLINE

Os dados do arquivo não estão disponíveis imediatamente. Esse atributo indica que os dados do arquivo foram movidos fisicamente para o armazenamento offline. Esse atributo é usado pelo Armazenamento Remoto, o software de gerenciamento de armazenamento hierárquico no Windows 2000. Se esse atributo for definido, o manipulador de colunas deverá evitar abrir o arquivo porque isso fará com que o arquivo seja retirado do armazenamento offline.

FILE_ATTRIBUTE_READONLY

O arquivo ou diretório é somente leitura. Os aplicativos podem ler o arquivo, mas não podem gravá-lo nem excluí-lo. No caso de um diretório, os aplicativos não podem excluí-lo.

FILE_ATTRIBUTE_REPARSE_POINT

O arquivo tem um ponto de nova análise associado.

FILE_ATTRIBUTE_SPARSE_FILE

O arquivo é um arquivo esparso.

FILE_ATTRIBUTE_SYSTEM

O arquivo ou diretório faz parte ou é usado exclusivamente pelo sistema operacional.

FILE_ATTRIBUTE_TEMPORARY

O arquivo está sendo usado para armazenamento temporário. Os sistemas de arquivos tentam manter todos os dados na memória para acesso mais rápido em vez de liberar os dados de volta para o armazenamento em massa. Um arquivo temporário deve ser excluído pelo aplicativo assim que ele não seja mais necessário.

dwReserved

Tipo: ULONG

Reservado. Defina como NULL.

pwszExt

Tipo: WCHAR*

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo com uma extensão de nome de arquivo.

wszFile[MAX_PATH]

Tipo: WCHAR[MAX_PATH]

Uma cadeia de caracteres Unicode terminada em nulo que contém um caminho de arquivo totalmente qualificado.

Requisitos

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

Confira também

GetFileAttributes

Share via