Methode ITcFileAccess:FileGetStatus

Fragt den Zustand einer Datei ab.

Syntax

virtual HRESULT TCOMAPI FileGetStatus(PCCH szFileName, PTcFileStatus pFileStatus));

Parameter

szFileName: (Typ: PCCH) [in] der Name der fraglichen Datei.

pFileStatus: (Typ: PTcFileStatus) [out] der Zustand der Datei, vgl. 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 fragt Zustandsinformationen bezüglich eines gegebenen Dateinamen ab.

Dazu gehören die folgenden Informationen:

typedef struct TcFileStatus
{
    union
    {
        ULONGLONG ulFileSize;
        struct
        {
            ULONG ulFileSizeLow;
            ULONG ulFileSizeHigh;
        };
    };
    ULONGLONG ulCreateTime;
    ULONGLONG ulModifiedTime;
    ULONGLONG ulReadTime;
    DWORD dwAttribute;
    DWORD wReserved0;
} TcFileStatus, *PTcFileStatus;