DragQueryFile

Функция DragQueryFile извлекает имена перемещенных мышью файлов.

UINT DragQueryFile (

    HDROP hDrop , // дескриптор структуры для перемещенных файлов
    UINT iFile , // индекс запрошенного файла
    LPTSTR lpszFile , // буфер для имени файла
    UINT cch  // размер буфера для имени файла
  ); 

Параметры

hDrop - идентифицирует структуру, содержащую имена файлов.
iFile - определяет индекс запрашиваемого файла. Если значение параметра iFile равно 0 xFFFFFFFF , DragQueryFile возвращает число перемещенных файлов. Если значение параметра iFile лежит между нулем и количеством перемещенных файлов, DragQueryFile копирует соответствующее значению им файла в буфер, указанный параметром lpszFile .
lpszFile - указывает на буфер для имени перемещенного файла. Им файла представляет собой завершающуюся нулем строку. Если значение lpszFile равно NULL , DragQueryFile возвращает необходимый размер буфера в символах.
cch - определяет размер буфера в символах.

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

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

См . также

DragQueryPoint .