Methode ITcFileAccess:FileTell

Fragt die derzeit gesetzte Position innerhalb einer Datei ab.

Syntax

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

Methode ITcFileAccess:FileTell 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

hFile

TcFileHandle

[in] verweist auf die zuvor geöffnete Datei.

puiPos

PUINT

[out] Speicherort der zurückzugebenden Position.