Поделиться через

Структура FILEDESCRIPTORA (shlobj_core.h)

  • Статья

Описывает свойства файла, копируемого с помощью буфера обмена во время операции перетаскивания перетаскивания Microsoft ActiveX.

Синтаксис

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;

Члены

dwFlags

Тип: DWORD

Массив флагов, указывающий, какие из других элементов структуры содержат допустимые данные. Этот элемент может быть сочетанием следующих значений.

FD_CLSID (0x00000001)

0x00000001. Допустимый элемент clsid.

FD_SIZEPOINT (0x00000002)

0x00000002. Допустимые элементы sizel и pointl.

FD_ATTRIBUTES (0x00000004)

0x00000004. Допустимый элемент dwFileAttributes.

FD_CREATETIME (0x00000008)

0x00000008. Допустимый элемент ftCreationTime.

FD_ACCESSTIME (0x00000010)

0x00000010. Допустимый элемент ftLastAccessTime.

FD_WRITESTIME (0x00000020)

0x00000020. Допустимый элемент ftLastWriteTime.

FD_FILESIZE (0x00000040)

0x00000040. Допустимы nFileSizeHigh и nFileSizeLow.

FD_PROGRESSUI (0x00004000)

0x00004000. Индикатор хода выполнения отображается с операциями перетаскивания.

FD_LINKUI (0x00008000)

0x00008000. Обработайте операцию как ярлык.

FD_UNICODE ((int)0x80000000)

(int)0x80000000. Windows Vista и более поздних версий. Дескриптор — Юникод.

clsid

Тип: CLSID

Идентификатор типа файла.

sizel

Тип: SIZEL

Ширина и высота значка файла.

pointl

Тип: POINTL

Координаты экрана объекта файла.

dwFileAttributes

Тип: DWORD

Флаги атрибутов файла. Это будет сочетание значений FILE_ATTRIBUTE_, описанных в GetFileAttributes.

ftCreationTime

Тип: FILETIME

Структура FILETIME, содержащая время создания файла.

ftLastAccessTime

Тип: FILETIME

Структура FILETIME, содержащая время последнего доступа к файлу.

ftLastWriteTime

Тип: FILETIME

Структура FILETIME, содержащая время последней операции записи.

nFileSizeHigh

Тип: DWORD

Высокий порядок DWORD размера файла в байтах.

nFileSizeLow

Тип: DWORD

Низкий порядок DWORD размера файла в байтах.

cFileName[MAX_PATH]

Тип: TCHAR[MAX_PATH]

Строка, завершающаяся значением NULL, содержащая имя файла.

Замечания

Если формат CFSTR_FILECONTENTS, соответствующий этой структуре, содержит файл как глобальный объект памяти, nFileSizeHigh и nFileSizeLow укажите размер связанного блока памяти. Если они заданы, их также можно использовать, если необходимо отобразить пользовательский интерфейс. Например, если файл будет перезаписан, обычно используется информация из этой структуры для отображения диалогового окна с размером, данными и именем файла.

Чтобы создать файл нулевой длины, задайте флаг FD_FILESIZE вdwFlags и задайте для nFileSizeHigh и nFileSizeLow. Формат CFSTR_FILECONTENTS должен представлять файл как поток или глобальный объект памяти (TYMED_ISTREAM или TYMED_HGLOBAL).

Заметка

Заголовок shlobj_core.h определяет FILEDESCRIPTOR как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows XP [только классические приложения]
минимальный поддерживаемый сервер Windows 2000 Server [только классические приложения]
заголовка shlobj_core.h