InternetFindNextFileA function (wininet.h)

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

BOOL InternetFindNextFileA(
  [in]  HINTERNET hFind,
  [out] LPVOID    lpvFindData
);

Parameters

[in] hFind

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

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

[out] lpvFindData

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).
 

Note

The wininet.h header defines InternetFindNextFile as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header wininet.h
Library Wininet.lib
DLL Wininet.dll

See also

Enabling Internet Functionality

WinINet Functions