Structure SHCOLUMNDATA (shlobj.h)

Contient des informations qui identifient un fichier particulier. Il est utilisé par IColumnProvider ::GetItemData lors de la demande de données pour un fichier particulier.

Syntaxe

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

Membres

dwFlags

Type : ULONG

Indicateurs utilisés pour spécifier la nature de la demande.

SHCDF_UPDATEITEM

Le fichier spécifié par wszFile est un nouveau fichier ou un fichier qui a changé depuis le dernier appel à IColumnProvider ::GetItemData. Toutes les données mises en cache doivent être vidées et recalculées. Les gestionnaires de colonnes qui ne mettez pas en cache les données ou qui affichent des données stockées séparément du fichier peuvent ignorer cet indicateur.

dwFileAttributes

Type : DWORD

Indicateurs d’attribut de fichier. Il s’agit d’une ou plusieurs des valeurs suivantes.

FILE_ATTRIBUTE_ARCHIVE

Le fichier ou le répertoire est un fichier ou un répertoire d’archive. Les applications utilisent cet attribut pour marquer des fichiers à des fins de sauvegarde ou de suppression.

FILE_ATTRIBUTE_COMPRESSED

Le fichier ou le répertoire est compressé. Pour un fichier, cela signifie que toutes les données du fichier sont compressées. Pour un répertoire, cela signifie que la compression est la valeur par défaut pour les fichiers et sous-répertoires nouvellement créés.

FILE_ATTRIBUTE_DIRECTORY

Le handle identifie un répertoire.

FILE_ATTRIBUTE_ENCRYPTED

Le fichier ou le répertoire est chiffré. Pour un fichier, cela signifie que tous les flux de données du fichier sont chiffrés. Pour un répertoire, cela signifie que le chiffrement est la valeur par défaut pour les fichiers et sous-répertoires nouvellement créés.

FILE_ATTRIBUTE_HIDDEN

Le fichier ou répertoire est masqué. Il n’est pas inclus dans une liste de répertoires classique.

FILE_ATTRIBUTE_NORMAL

Le fichier ou le répertoire n'a pas d'autres attributs définis. Cet attribut n’est valide que s’il est utilisé seul.

FILE_ATTRIBUTE_OFFLINE

Les données du fichier ne sont pas immédiatement disponibles. Cet attribut indique que les données de fichier ont été physiquement déplacées vers le stockage hors connexion. Cet attribut est utilisé par le stockage à distance, le logiciel de gestion du stockage hiérarchique dans Windows 2000. Si cet attribut est défini, le gestionnaire de colonnes doit éviter d’ouvrir le fichier, car cela entraîne le rappel du fichier du stockage hors connexion.

FILE_ATTRIBUTE_READONLY

Le fichier ou le répertoire est en lecture seule. Les applications peuvent lire le fichier, mais ne peuvent pas y écrire ou le supprimer. Dans le cas d’un répertoire, les applications ne peuvent pas le supprimer.

FILE_ATTRIBUTE_REPARSE_POINT

Le fichier a un point d’analyse associé.

FILE_ATTRIBUTE_SPARSE_FILE

Le fichier est un fichier partiellement alloué.

FILE_ATTRIBUTE_SYSTEM

Le fichier ou le répertoire fait partie du système d’exploitation ou est utilisé exclusivement par celui-ci.

FILE_ATTRIBUTE_TEMPORARY

Le fichier est utilisé pour le stockage temporaire. Les systèmes de fichiers tentent de conserver toutes les données en mémoire pour un accès plus rapide plutôt que de vider les données dans le stockage de masse. Un fichier temporaire doit être supprimé par l’application dès qu’il n’est plus nécessaire.

dwReserved

Type : ULONG

Réservé. Défini sur NULL.

pwszExt

Type : WCHAR*

Pointeur vers une chaîne Unicode terminée par null avec une extension de nom de fichier.

wszFile[MAX_PATH]

Type : WCHAR[MAX_PATH]

Chaîne Unicode terminée par null contenant un chemin d’accès de fichier complet.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	shlobj.h

Voir aussi

GetFileAttributes