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

Комментарии

Требования

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

DragQueryPoint