Methode ITcFileAccess:FileFindFirst

Möglichkeit, die Dateien eines Verzeichnisses zu durchlaufen.

Syntax


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

Methode ITcFileAccess:FileFindFirst 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

szFileName

PCCH

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

pFileFindData

PTcFileFindData

[out] die Beschreibung der ersten Datei, vgl. TcFileAccessServices.h

phFileFind

PTcFileFindHandle

[out] Handle um weiter mit FileFindNext zu suchen.

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;