|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| Yes
| Win32s
| Yes
| Import Library
| shell32.lib
| Header File
| shellapi.h
| Unicode
| WinNT
| Platform Notes
| None
|
|
|
DragQueryFile
The DragQueryFile function retrieves the filenames of dropped files.
UINT DragQueryFile(
HDROP hDrop,
| // handle to structure for dropped files
| UINT iFile,
| // index of file to query
| LPTSTR lpszFile,
| // buffer for returned filename
| UINT cch
| // size of buffer for filename
| );
|
|
Parameters
hDrop
Identifies the structure containing the filenames of the dropped files.
iFile
Specifies the 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 filename with the corresponding value to the buffer pointed to by
the lpszFile parameter.
lpszFile
Points to a buffer to receive the filename of a dropped file when the function
returns. This filename is a null-terminated string. If this parameter is NULL, DragQueryFile returns the required size, in characters, of the buffer.
cch
Specifies the size, in characters, of the lpszFile buffer.
Return Values
When the function copies a filename 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.
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.
See Also
DragQueryPoint
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
More Online Helps
Win32 Programmer's Reference (win32.hlp)
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|