InternetFindNextFile function

Continues a file search started as a result of a previous call to FtpFindFirstFile.

Windows XP and Windows Server 2003 R2 and earlier: Or continues a file search as a result of a previous call to GopherFindFirstFile.

Syntax

C++


BOOL InternetFindNextFile(
  _In_  HINTERNET hFind,
  _Out_ LPVOID    lpvFindData
);

Parameters

hFind [in]

Handle returned from either FtpFindFirstFile or InternetOpenUrl (directories only).

Windows XP and Windows Server 2003 R2 and earlier: Also a handle returned from GopherFindFirstFile.

lpvFindData [out]

Pointer to the buffer that receives information about the file or directory. The format of the information placed in the buffer depends on the protocol in use. The FTP protocol returns a WIN32_FIND_DATA structure.

Windows XP and Windows Server 2003 R2 and earlier: The Gopher protocol returns a GOPHER_FIND_DATA structure.

Return value

Returns TRUE if the function succeeds, or FALSE otherwise. To get extended error information, call GetLastError. If the function finds no matching files, GetLastError returns ERROR_NO_MORE_FILES.

Remarks

Note WinINet does not support server implementations. In addition, it should not be used from a service. For server implementations or services use Microsoft Windows HTTP Services (WinHTTP).

Requirements

Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Header	Wininet.h
Library	Wininet.lib
DLL	Wininet.dll
Unicode and ANSI names	InternetFindNextFileW (Unicode) and InternetFindNextFileA (ANSI)