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


Функция 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)

См. также раздел

DragQueryPoint