Methode ITcFileAccess:FileFindNext

Die Dateien eines Verzeichnisses weiter durchlaufen.

Syntax

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

Parameter

hFileFind: (Typ: PTcFileFindHandle) [in] Handle um weiter mit FileFindNext zu suchen.

pFileFindData: (Typ: PTcFileFindData) [out] die Beschreibung der nächsten Datei. Vergleiche mit TcFileAccessServices.h

Rückgabewert

Bei Erfolg wird S_OK („0“) oder ein anderer positiver Wert zurückgegeben, vgl. Rückgabewerte. Erweiterte Meldungen beziehen sich dabei insbesondere auf die Spalte HRESULT in ADS Return Codes.

Ein besonders interessanter Fehlercode ist ADSERR_DEVICE_TIMEOUT wenn die Zeitüberschreitung (5 Sekunden) abgelaufen ist.

Beschreibung

Diese Methode sucht nach der nächsten Datei in einem Verzeichnis. Die Methode gewährt Zugriff auf PTcFileFindData der gefundenen Datei, mit folgenden Informationen:

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;