Функция DragQueryFileA (shellapi.h)
Извлекает имена удаленных файлов, которые возникают в результате успешной операции перетаскивания.
Синтаксис
UINT DragQueryFileA(
[in] HDROP hDrop,
[in] UINT iFile,
[out] LPSTR 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 [только классические приложения] |
Целевая платформа | Windows |
Header | shellapi.h |
Библиотека | Shell32.lib |
DLL | Shell32.dll (версия 4.0 или более поздняя) |
Набор API | ext-ms-win-shell-shell32-l1-2-1 (представлено в Windows 10 версии 10.0.10240) |