Methode ITcFileAccess:FileOpen

Öffnet eine Datei.

Syntax

virtual HRESULT TCOMAPI FileOpen(PCCH szFileName, TcFileAccessMode AccessMode, PTcFileHandle phFile);

Parameter

szFileName: (Typ: PCCH) [in] der Name der zu öffnenden Datei.

AccessMode: (Typ: TcFileAccessMode) [in] Art des Zugriffs auf die Datei, siehe TcFileAccessServices.h.

phFile: (Typ: TcFileHandle) [out] zurückgegebener Datei-Handle.

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

Die Methode gibt einen Handle für den Zugriff auf die Datei zurück, dessen Name in szFileName definiert ist.

AccessModes können folgendermaßen verwendet werden:

typedef enum TcFileAccessMode
{
    amRead = 0x00000001,
    amWrite = 0x00000002,
    amAppend = 0x00000004,
    amPlus = 0x00000008,
    amBinary = 0x00000010,
    amReadBinary = 0x00000011,
    amWriteBinary = 0x00000012,
    amText = 0x00000020,
    amReadText = 0x00000021,
    amWriteText = 0x00000022,
    amEnsureDirectory = 0x00000040,
    amReadBinaryED = 0x00000051,
    amWriteBinaryED = 0x00000052,
    amReadTextED = 0x00000061,
    amWriteTextED = 0x00000062,
    amEncryption = 0x00000080,
    amReadBinEnc = 0x00000091,
    amWriteBinEnc = 0x00000092,
    amReadBinEncED = 0x000000d1,
    amWriteBinEncED = 0x000000d2,
} TcFileAccessMode, *PTcFileAccessMode;