Methode ITcFileAccess:FileSeek

Setzt Position in einer Datei.

Syntax

virtual HRESULT TCOMAPI FileSeek(TcFileHandle hFile, UINT uiPos);

Parameter

hFile: (Typ: TcFileHandle) [in] verweist auf die zuvor geöffnete Datei.

uiPos: (Typ: UINT) [in] Position auf die zu setzen ist.

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 legt die Position innerhalb einer Datei für weitere Aktionen fest.