IFillLockBytes::FillAt-Methode (objidl.h)
Die FillAt-Methode schreibt einen neuen Datenblock an einen angegebenen Speicherort im Bytearray.
Syntax
HRESULT FillAt(
[in] ULARGE_INTEGER ulOffset,
[in] const void *pv,
[in] ULONG cb,
[out] ULONG *pcbWritten
);
Parameter
[in] ulOffset
Der Offset, ausgedrückt in Anzahl von Bytes, aus dem ersten Element des Bytearrays.
[in] pv
Zeiger auf die Daten, die an der von uIOffset angegebenen Position geschrieben werden sollen.
[in] cb
Größe von pv in Bytes.
[out] pcbWritten
Anzahl der Bytes, die erfolgreich geschrieben wurden.
Rückgabewert
Diese Funktion unterstützt zusätzlich die folgenden Standardrückgabewerte E_OUTOFMEMORY, E_UNEXPECTED, E_INVALIDARG und E_FAIL:
Rückgabecode | BESCHREIBUNG |
---|---|
E_NOTIMPL | Das Bytearray unterstützt die FillAt-Methode nicht. |
Hinweise
Die FillAt-Methode wird für nichtsequentiale Downloads (z. B. HTTP-Bytebereichsanforderungen) verwendet. Beim nichtsequentialen Download gibt der Aufrufer Bereiche im Bytearray an, in denen verschiedene Datenblöcke geschrieben werden sollen. Nachfolgende Aufrufe der Zusammengesetzten Dateiimplementierung von ILockBytes::ReadAt werden von der eigenen Implementierung von ILockBytes des Bytearray-Wrapperobjekts an das zugrunde liegende Bytearray übergeben. Diese Methode ist derzeit nicht implementiert und gibt E_NOTIMPL zurück.
Anforderungen
Anforderung | Wert |
---|---|
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 |