Methode ITcFileAccess:FileGetStatus

Fragt den Zustand einer Datei ab.

Syntax

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

Methode ITcFileAccess:FileGetStatus 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] der Name der fraglichen Datei.

pFileStatus

PTcFileStatus

[out] der Zustand der Datei, vgl. TcFileAccessServices.h .

Beschreibung

Diese Methode fragt Zustandsinformationen bezüglich eines gegebenen Dateinamens 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;