Methode ITcFileAccess:FileRead

Liest Daten aus einer Datei.

Syntax

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

Parameter

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

pData: (Typ: PVOID) [out] Speicherort der zu lesenden Daten.

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

pcbRead: (Typ: PUINT) [out] Größe der gelesenen Daten.

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 Daten von einer mit Dateihandle definierten Datei ab. Die Daten werden in pData gespeichert, wobei pcbRead die Länge der Daten angibt.