FILEDESCRIPTOR structure

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 _FILEDESCRIPTOR {
  DWORD    dwFlags;
  CLSID    clsid;
  SIZEL    sizel;
  POINTL   pointl;
  DWORD    dwFileAttributes;
  FILETIME ftCreationTime;
  FILETIME ftLastAccessTime;
  FILETIME ftLastWriteTime;
  DWORD    nFileSizeHigh;
  DWORD    nFileSizeLow;
  TCHAR    cFileName[MAX_PATH];
} FILEDESCRIPTOR, *LPFILEDESCRIPTOR;

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

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).

Requirements

Send comments about this topic to Microsoft

Build date: 11/28/2012