Method ITcFileAccess:FileTell

Queries the currently set position within a file.

Syntax

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

Method ITcFileAccess:FileTell 1: 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.

Parameter

Name

Type

Description

hFile

TcFileHandle

[in] refers to the previously opened file.

puiPos

PUINT

[out] storage location of the position to be returned.