Method ITcFileAccess:FileFindNext

Continue scanning the files in a directory.

Syntax

virtual HRESULT TCOMAPI FileFindNext (TcFileFindHandle hFileFind, PTcFileFindData pFileFindData);

Method ITcFileAccess:FileFindNext 1: Return value

If successful, S_OK ("0") or another positive value will be returned, cf. Return values. Extended messages refer in particular to the column HRESULT in ADS Return Codes.

A particularly interesting error code is ADSERR_DEVICE_TIMEOUT if the timeout (5 seconds) has elapsed.

Parameter

Name

Type

Description

hFileFind

PTcFileFindHandle

[in] handle for searching further with FileFindNext.

pFileFindData

PTcFileFindData

[out] the description of the next file. Compare with TcFileAccessServices.h

Description

This method searches for the next file in a directory. The method grants access to PTcFileFindData of the file found, with the following information: 

typedef struct TcFileFindData
{
    TcFileHandle hFile;
    DWORD dwFileAttributes;
    ULONGLONG ui64CreationTime;
    ULONGLONG ui64LastAccessTime;
    ULONGLONG ui64LastWriteTime;
    DWORD dwFileSizeHigh;
    DWORD dwFileSizeLow;
    DWORD dwReserved1;
    DWORD dwReserved2;
    CHAR cFileName[260];
    CHAR cAlternateFileName[14];
    WORD wReserved0;
} TcFileFindData, *PTcFileFindData;