Freigeben über


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.

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