Freigeben über


IFillLockBytes::FillAppend-Methode (objidl.h)

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