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 |