IFillLockBytes::FillAppend-Methode (objidl.h)

Artikel
08/25/2023

Die FillAppend-Methode schreibt einen neuen Block von Bytes an das Ende eines Bytearrays.

Syntax

HRESULT FillAppend(
  [in]  const void *pv,
  [in]  ULONG      cb,
  [out] ULONG      *pcbWritten
);

Parameter

[in] pv

Zeiger auf die Daten, die am Ende eines vorhandenen Bytearrays angefügt werden sollen. Durch diesen Vorgang besteht keine Gefahr eines Speicherverlusts oder eines Pufferüberlaufs.

[in] cb

Größe von pv in Bytes.

[out] pcbWritten

Anzahl der Bytes, die erfolgreich geschrieben wurden.

Rückgabewert

Diese Funktion unterstützt die Standardrückgabewerte E_OUTOFMEMORY, E_UNEXPECTED, E_INVALIDARG und E_FAIL.

Hinweise

Die FillAppend-Methode wird für das sequenzielle Herunterladen verwendet, wobei Bytes in der Reihenfolge, in der sie empfangen werden, an das Ende des Bytearrays geschrieben werden. Diese Methode ruft die aktuelle Größe des Bytearrays ab (z. B. das Lockbytes-Objekt) und schreibt einen neuen Datenblock an das Ende des Arrays. Wenn jeder Datenblock verfügbar wird, ruft der Downloader diese Methode auf, um sie in das Bytearray zu schreiben. Nachfolgende Aufrufe der Verbunddateiimplementierung von ILockBytes::ReadAt geben alle verfügbaren Daten zurück oder geben E_PENDING zurück, wenn derzeit keine Daten verfügbar sind.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	objidl.h
Bibliothek	Uuid.lib
DLL	Ole32.dll

Weitere Informationen

ILockBytes

Share via