Функция DragQueryFileW (shellapi.h)

Извлекает имена удаленных файлов, которые приводят к успешной операции перетаскивания.

Синтаксис

UINT DragQueryFileW(
  [in]  HDROP  hDrop,
  [in]  UINT   iFile,
  [out] LPWSTR lpszFile,
        UINT   cch
);

Параметры

[in] hDrop

Тип: HDROP

Идентификатор структуры, содержащей имена файлов удаленных файлов.

[in] iFile

Тип: UINT

Индекс файла для запроса. Если значение этого параметра 0xFFFFFFFF, DragQueryFile возвращает количество удаленных файлов. Если значение этого параметра составляет от нуля до общего количества файлов, DragQueryFile копирует имя файла с соответствующим значением в буфер, на который указывает параметр lpszFile.

[out] lpszFile

Тип: LPTSTR

Адрес буфера, который получает имя файла удаленного файла при возврате функции. Это имя файла является строкой, завершающейся значением NULL. Если этот параметр null, DragQueryFile возвращает требуемый размер в символах этого буфера.

cch

Тип: UINT

Размер в символах буфера lpszFile .

Возвращаемое значение

Тип: UINT

Значение, отличное от нуля, указывает на успешный вызов.

Когда функция копирует имя файла в буфер, возвращаемое значение является числом скопированных символов, не включая завершающий символ NULL.

Если значение индекса 0xFFFFFFFF, возвращаемое значение является числом удаленных файлов. Обратите внимание, что сама переменная индекса возвращает неизменное значение и поэтому остается 0xFFFFFFFF.

Если значение индекса составляет от нуля до общего количества удаленных файлов, а адрес буфера lpszFile равен NULL, возвращаемое значение является обязательным размером в символах буфера, не включая завершающий символ NULL.

Замечания

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	shellapi.h
библиотеки	Shell32.lib
DLL	Shell32.dll (версия 4.0 или более поздняя версия)
набор API	ext-ms-win-shell-shell32-l1-2-1 (представлено в Windows 10 версии 10.0.10240)

См. также

DragQueryPoint