Methode ITcFileAccess:FileWrite

Daten in eine Datei schreiben.

Syntax

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

Methode ITcFileAccess:FileWrite 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

[in] Speicherort der zu schreibenden Daten.

cbData

PVOID

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

pcbRead

PUINT

[out] Größe der geschriebenen Daten.