STRUCTURE FILEDESCRIPTORW (shlobj_core.h)
Décrit les propriétés d’un fichier en cours de copie au moyen du Presse-papiers pendant une opération de glisser-déplacer
Syntaxe
typedef struct _FILEDESCRIPTORW {
DWORD dwFlags;
CLSID clsid;
SIZEL sizel;
POINTL pointl;
DWORD dwFileAttributes;
FILETIME ftCreationTime;
FILETIME ftLastAccessTime;
FILETIME ftLastWriteTime;
DWORD nFileSizeHigh;
DWORD nFileSizeLow;
WCHAR cFileName[MAX_PATH];
} FILEDESCRIPTORW, *LPFILEDESCRIPTORW;
Membres
dwFlags
Type : DWORD
Tableau d’indicateurs qui indiquent quels membres de la structure contiennent des données valides. Ce membre peut être une combinaison des valeurs suivantes.
FD_CLSID (0x00000001)
0x00000001. Le membre clsid est valide.
FD_SIZEPOINT (0x00000002)
0x00000002. Les membres sizel et pointl sont valides.
FD_ATTRIBUTES (0x00000004)
0x00000004. Le membre dwFileAttributes est valide.
FD_CREATETIME (0x00000008)
0x00000008. Le membre ftCreationTime est valide.
FD_ACCESSTIME (0x00000010)
0x00000010. Le membre ftLastAccessTime est valide.
FD_WRITESTIME (0x00000020)
0x00000020. Le membre ftLastWriteTime est valide.
FD_FILESIZE (0x00000040)
0x00000040. Les membres nFileSizeHigh et nFileSizeLow sont valides.
FD_PROGRESSUI (0x00004000)
0x00004000. Un indicateur de progression s’affiche avec les opérations de glisser-déplacer.
FD_LINKUI (0x00008000)
0x00008000. Traitez l’opération comme un raccourci.
FD_UNICODE ((int)0x80000000)
(int)0x80000000. Windows Vista et versions ultérieures. Le descripteur est Unicode.
clsid
Type : CLSID
Identificateur de type de fichier.
sizel
Type : SIZEL
Largeur et hauteur de l’icône de fichier.
pointl
Type : POINTL
Coordonnées de l’écran de l’objet fichier.
dwFileAttributes
Type : DWORD
Indicateurs d’attribut de fichier. Il s’agit d’une combinaison des valeurs de FILE_ATTRIBUTE_ décrites dans GetFileAttributes.
ftCreationTime
Type : FILETIME
Structure FILETIME qui contient l’heure de création du fichier.
ftLastAccessTime
Type : FILETIME
La structure FILETIME qui contient l’heure à laquelle le fichier a été accédé pour la dernière fois.
ftLastWriteTime
Type : FILETIME
Structure FILETIME qui contient l’heure de la dernière opération d’écriture.
nFileSizeHigh
Type : DWORD
L’ordre élevé DWORD de la taille du fichier, en octets.
nFileSizeLow
Type : DWORD
L’ordre faible DWORD de la taille du fichier, en octets.
cFileName[MAX_PATH]
Type : TCHAR[MAX_PATH]
Chaîne terminée par null qui contient le nom du fichier.
Remarques
Si le format CFSTR_FILECONTENTS qui correspond à cette structure contient le fichier en tant qu’objet de mémoire globale, nFileSizeHigh et nFileSizeLow spécifier la taille du bloc de mémoire associé. S’ils sont définis, ils peuvent également être utilisés si une interface utilisateur doit être affichée. Par exemple, si un fichier est sur le point d’être remplacé, vous utilisez généralement des informations de cette structure pour afficher une boîte de dialogue contenant la taille, les données et le nom du fichier.
Pour créer un fichier de longueur zéro, définissez l’indicateur
Note
L’en-tête shlobj_core.h définit FILEDESCRIPTOR comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows XP [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| d’en-tête | shlobj_core.h |