Struttura SHCOLUMNDATA (shlobj.h)

  • Articolo

Contiene informazioni che identificano un file specifico. Viene usato da IColumnProvider::GetItemData quando si richiedono dati per un determinato file.

Sintassi

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

Members

dwFlags

Tipo: ULONG

Flag usati per specificare la natura della richiesta.

SHCDF_UPDATEITEM

Il file specificato da wszFile è un nuovo file o un file modificato dall'ultima chiamata a IColumnProvider::GetItemData. Tutti i dati memorizzati nella cache devono essere scaricati e ricalcolati. I gestori di colonne che non memorizzano nella cache i dati o che visualizzano i dati archiviati separatamente dal file, possono ignorare questo flag.

dwFileAttributes

Tipo: DWORD

Flag di attributo file. Sarà uno o più dei valori seguenti.

FILE_ATTRIBUTE_ARCHIVE

Il file o la directory è un file di archivio o una directory. Le applicazioni usano questo attributo per contrassegnare i file per il backup o la rimozione.

FILE_ATTRIBUTE_COMPRESSED

Il file o la directory è compresso. Per un file, ciò significa che tutti i dati nel file vengono compressi. Per una directory, ciò significa che la compressione è l'impostazione predefinita per i file appena creati e le sottodirectory.

FILE_ATTRIBUTE_DIRECTORY

L'handle identifica una directory.

FILE_ATTRIBUTE_ENCRYPTED

Il file o la directory è crittografato. Per un file, ciò significa che tutti i flussi di dati nel file vengono crittografati. Per una directory, ciò significa che la crittografia è l'impostazione predefinita per i file appena creati e le sottodirectory.

FILE_ATTRIBUTE_HIDDEN

Il file o la directory è nascosta. Non è incluso in un elenco di directory normale.

FILE_ATTRIBUTE_NORMAL

Il file o la directory non dispone di altri attributi impostati. Questo attributo è valido solo se usato da solo.

FILE_ATTRIBUTE_OFFLINE

I dati del file non sono immediatamente disponibili. Questo attributo indica che i dati del file sono stati spostati fisicamente nell'archiviazione offline. Questo attributo viene usato da Archiviazione remota, il software di gestione delle risorse di archiviazione gerarchica in Windows 2000. Se questo attributo è impostato, il gestore di colonne deve evitare di aprire il file perché in questo modo il file verrà richiamato dall'archiviazione offline.

FILE_ATTRIBUTE_READONLY

Il file o la directory è di sola lettura. Le applicazioni possono leggere il file, ma non possono scriverlo o eliminarlo. Nel caso di una directory, le applicazioni non possono eliminarle.

FILE_ATTRIBUTE_REPARSE_POINT

Il file ha un punto di ripristino associato.

FILE_ATTRIBUTE_SPARSE_FILE

Il file è un file sparse.

FILE_ATTRIBUTE_SYSTEM

Il file o la directory fa parte di o viene usato esclusivamente dal sistema operativo.

FILE_ATTRIBUTE_TEMPORARY

Il file viene usato per l'archiviazione temporanea. I file system tentano di mantenere tutti i dati in memoria per l'accesso più rapido anziché scaricare i dati nell'archiviazione di massa. L'applicazione dovrebbe eliminare un file temporaneo quando non è più necessario.

dwReserved

Tipo: ULONG

Riservato. Impostare su NULL.

pwszExt

Tipo: WCHAR*

Puntatore a una stringa Unicode con terminazione null con estensione nome file.

wszFile[MAX_PATH]

Tipo: WCHAR[MAX_PATH]

Stringa Unicode con terminazione null contenente un percorso di file completo.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Intestazione shlobj.h

Vedi anche

GetFileAttributes