Method ITcFileAccess:FileTell

Retrieves position in file.

Syntax

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

Parameter

hFile: (type: TcFileHandle) [in] refers to the previously opened file.

puiPos: (type: PUINT) [out] storage location of the position to be returned.

Return value

If successful, S_OK ("0") or another positive value will be returned, cf. Return values. Extended messages refer in particular to the column HRESULT in ADS Return Codes.

A particularly interesting error code is ADSERR_DEVICE_TIMEOUT if the timeout (5 seconds) has elapsed.

Description

This method retrieves the position within the file, which is currently set.