ILockBytes – File-Based Implementierung

  • Artikel

Wird für ein Bytearrayobjekt implementiert, das einem COM-Verbunddateispeicherobjekt zugrunde liegt, und ist für das direkte Lesen und Schreiben in eine Datenträgerdatei konzipiert.

Einsatzgebiet

Methoden von ILockBytes werden aus den Verbunddateiimplementierungen von IStorage und IStream für das Verbunddateispeicherobjekt aufgerufen, das durch einen Aufruf von StgCreateDocfile erstellt wurde, sodass Sie sie nicht direkt aufrufen müssen.

Bemerkungen

Im Folgenden sind die Methoden der ILockBytes -File-Based-Implementierung aufgeführt.

ILockBytes::ReadAt

Liest einen Block von Bytes aus einem angegebenen Offset am Anfang des Bytearrays.

ILockBytes::WriteAt

Schreibt einen Byteblock aus einem angegebenen Offset am Anfang des Bytearrays.

ILockBytes::Flush

Stellt sicher, dass alle von der ILockBytes-Implementierung verwalteten internen Puffer in den zugrunde liegenden physischen Speicher geschrieben werden.

ILockBytes::SetSize

Legt die Größe des Bytearrays fest.

ILockBytes::LockRegion

Der dwLockTypes-Parameter ist auf LOCK_ONLYONCE oder LOCK_EXCLUSIVE festgelegt, wodurch der Zugriff auf gesperrte Regionen zugelassen oder eingeschränkt wird.

ILockBytes::UnlockRegion

Diese Methode entsperrt die durch ILockBytes::LockRegion gesperrte Region.

ILockBytes::Stat

Die VON COM bereitgestellte IStorage::Stat-Implementierung ruft die ILockBytes::Stat-Methode auf, um Informationen zum Bytearrayobjekt abzurufen. Wenn kein vernünftiger Name für das Bytearray vorhanden ist, gibt die VON COM bereitgestellte ILockBytes::Stat-Methodenull im pwcsName-Member der STATSTG-Struktur zurück.

ILockBytes

IStorage

IStream