Methode ITcFileAccess:FileTell

Fragt Position in einer Datei ab.

Syntax

virtual HRESULT TCOMAPI FileTell(TcFileHandle hFile, PUINT puiPos);

Parameter

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

puiPos: (Typ: PUINT) [out] Speicherort der zurückzugebenden Position.

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 die derzeit gesetzte Position innerhalb einer Datei ab.