Methode ITcFileAccess:FileFindFirst

Möglichkeit, die Dateien eines Verzeichnisses zu durchlaufen.

Syntax

virtual HRESULT TCOMAPI FileFindFirst (PCCH szFileName, PTcFileFindData pFileFindData , PTcFileFindHandle phFileFind);

Parameter

szFileName: (Typ: PCCH) [in] Verzeichnis oder Pfad, und Name der gesuchten Datei. Der Dateiname kann Platzhalterzeichen wie Sternchen (*) oder Fragezeichen (?) enthalten.

pFileFindData: (Typ: PTcFileFindData) [out] die Beschreibung der ersten Datei, vgl. TcFileAccessServices.h

phFileFind: (Typ: PTcFileFindHandle) [out] Handle um weiter mit FileFindNext zu suchen.

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 beginnt mit der Suche nach Dateien in einem vorgegebenen Verzeichnis. Die Methode gewährt Zugriff auf PTcFileFindData der ersten 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;