Methode ITcFileAccess:FileFindNext

Die Dateien eines Verzeichnisses weiter durchlaufen.

Syntax

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

Methode ITcFileAccess:FileFindNext 1: 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.

Parameter

Name

Typ

Beschreibung

hFileFind

PTcFileFindHandle

[in] Handle, um weiter mit FileFindNext zu suchen.

pFileFindData

PTcFileFindData

[out] die Beschreibung der nächsten Datei. Vergleiche mit TcFileAccessServices.h

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;