FILEDESCRIPTORA structure (shlobj_core.h)
Describes the properties of a file that is being copied by means of the clipboard during a Microsoft ActiveX drag-and-drop operation.
Syntax
typedef struct _FILEDESCRIPTORA {
DWORD dwFlags;
CLSID clsid;
SIZEL sizel;
POINTL pointl;
DWORD dwFileAttributes;
FILETIME ftCreationTime;
FILETIME ftLastAccessTime;
FILETIME ftLastWriteTime;
DWORD nFileSizeHigh;
DWORD nFileSizeLow;
CHAR cFileName[MAX_PATH];
} FILEDESCRIPTORA, *LPFILEDESCRIPTORA;
Members
dwFlags
Type: DWORD
An array of flags that indicate which of the other structure members contain valid data. This member can be a combination of the following values.
FD_CLSID (0x00000001)
0x00000001. The clsid member is valid.
FD_SIZEPOINT (0x00000002)
0x00000002. The sizel and pointl members are valid.
FD_ATTRIBUTES (0x00000004)
0x00000004. The dwFileAttributes member is valid.
FD_CREATETIME (0x00000008)
0x00000008. The ftCreationTime member is valid.
FD_ACCESSTIME (0x00000010)
0x00000010. The ftLastAccessTime member is valid.
FD_WRITESTIME (0x00000020)
0x00000020. The ftLastWriteTime member is valid.
FD_FILESIZE (0x00000040)
0x00000040. The nFileSizeHigh and nFileSizeLow members are valid.
FD_PROGRESSUI (0x00004000)
0x00004000. A progress indicator is shown with drag-and-drop operations.
FD_LINKUI (0x00008000)
0x00008000. Treat the operation as a shortcut.
FD_UNICODE ((int)0x80000000)
(int)0x80000000. Windows Vista and later. The descriptor is Unicode.
clsid
Type: CLSID
The file type identifier.
sizel
Type: SIZEL
The width and height of the file icon.
pointl
Type: POINTL
The screen coordinates of the file object.
dwFileAttributes
Type: DWORD
File attribute flags. This will be a combination of the FILE_ATTRIBUTE_ values described in GetFileAttributes.
ftCreationTime
Type: FILETIME
The FILETIME structure that contains the time of file creation.
ftLastAccessTime
Type: FILETIME
The FILETIME structure that contains the time that the file was last accessed.
ftLastWriteTime
Type: FILETIME
The FILETIME structure that contains the time of the last write operation.
nFileSizeHigh
Type: DWORD
The high-order DWORD of the file size, in bytes.
nFileSizeLow
Type: DWORD
The low-order DWORD of the file size, in bytes.
cFileName[MAX_PATH]
Type: TCHAR[MAX_PATH]
The null-terminated string that contains the name of the file.
Remarks
If the CFSTR_FILECONTENTS format that corresponds to this structure contains the file as a global memory object, nFileSizeHigh and nFileSizeLow specify the size of the associated memory block. If they are set, they can also be used if a user-interface needs to be displayed. For example, if a file is about to be overwritten, you would typically use information from this structure to display a dialog box containing the size, data, and name of the file.
To create a zero-length file, set the FD_FILESIZE flag in the dwFlags, and set nFileSizeHigh and nFileSizeLow to zero. The CFSTR_FILECONTENTS format should represent the file as either a stream or global memory object (TYMED_ISTREAM or TYMED_HGLOBAL).
Note
The shlobj_core.h header defines FILEDESCRIPTOR as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows XP [desktop apps only] |
Minimum supported server | Windows 2000 Server [desktop apps only] |
Header | shlobj_core.h |