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 |