Methode ITcFileAccess:FileOpen

Öffnet eine Datei.

Syntax


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

Methode ITcFileAccess:FileOpen 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 zu öffnenden Datei.

AccessMode

TcFileAccessMode

[in] Art des Zugriffs auf die Datei, siehe TcFileAccessServices.h.

phFile

TcFileHandle

[out] zurückgegebener Datei-Handle.

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;