DragQueryFile Function

最新推荐文章于 2023-11-27 23:33:24 发布

转载最新推荐文章于 2023-11-27 23:33:24 发布 · 474 阅读

文章标签：

#function #buffer #file #null #structure

Shell extension 专栏收录该内容

2 篇文章

订阅专栏

本文介绍DragQueryFile函数的使用方法，该函数用于检索拖放操作中丢弃的文件名。文章详细解释了函数的参数含义及其返回值的意义。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Retrieves the names of dropped files that result from a successful drag-and-drop operation.

Syntax

UINT DragQueryFile(      
    HDROP hDrop,
    UINT iFile,
    LPTSTR lpszFile,
    UINT cch
);

Parameters

hDrop
Identifier of the structure containing the file names of the dropped files.
iFile
Index of the file to query. If the value of the iFile parameter is 0xFFFFFFFF, DragQueryFile returns a count of the files dropped. If the value of the iFile parameter is between zero and the total number of files dropped, DragQueryFile copies the file name with the corresponding value to the buffer pointed to by the lpszFile parameter.
lpszFile
The address of a buffer to receive the file name of a dropped file when the function returns. This file name is a null-terminated string. If this parameter is NULL, DragQueryFile returns the required size, in characters, of the buffer.
cch
Size, in characters, of the lpszFile buffer.

Return Value

When the function copies a file name to the buffer, the return value is a count of the characters copied, not including the terminating null character.

If the index value is 0xFFFFFFFF, the return value is a count of the dropped files. Note that the index variable itself returns unchanged, and will therefore remain 0xFFFFFFFF.

If the index value is between zero and the total number of dropped files and the lpszFile buffer address is NULL, the return value is the required size, in characters, of the buffer, not including the terminating null character.