IFillLockBytes::FillAt-Methode (objidl.h)

Artikel
02/29/2024

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.

Hinweis Die vom System bereitgestellte IFillLockBytes-Implementierung unterstützt FillAt nicht 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

Weitere Informationen

IFillLockBytes – Implementierung

IFillLockBytes::FillAppend

ILockBytes::ReadAt

Share via