Methode ITcFileAccess:FileRead

Liest Daten aus einer Datei.

Syntax

virtual HRESULT TCOMAPI
FileRead(TcFileHandle hFile, PVOID pData, UINT cbData, PUINT pcbRead);

Methode ITcFileAccess:FileRead 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.

pData

PVOID

[out] Speicherort der zu lesenden Daten.

cbData

PVOID

[in] maximale Größe der zu lesenden Daten (Größe des Speichers hinter pData).

pcbRead

PUINT

[out] Größe der gelesenen Daten.