Methode ITcFileAccess:FileWrite

Daten in eine Datei schreiben.

Syntax

virtual HRESULT TCOMAPI
FileWrite(TcFileHandle hFile, PCVOID pData, UINT cbData, PUINT pcbWrite);

Parameter

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

pData: (Typ: PVOID) [in] Speicherort der zu schreibenden Daten.

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

pcbRead: (Typ: PUINT) [out] Größe der geschriebenen 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 schreibt Daten in eine mit Dateihandle definierte Datei. Die Daten werden in pData gelesen, wobei pcbRead die Länge der Daten angibt.