ILockBytes – Globale Speicherimplementierung

  • Artikel

Die globale ILockBytes-Speicherimplementierung wird in einem Bytearrayobjekt implementiert, das einem COM-Verbunddateispeicherobjekt zugrunde liegt, und ist für direktes Lesen und Schreiben in den globalen Speicher 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.

Bemerkungen

Im Folgenden sind die Methoden der globalen ILockBytes-Speicherimplementierung aufgeführt.

ILockBytes::ReadAt

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

ILockBytes::WriteAt

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

ILockBytes::Flush

Im Gegensatz zur dateibasierten Implementierung hat das Aufrufen dieser Methode in der globalen Speicherimplementierung keine Auswirkungen.

ILockBytes::SetSize

Legt die Größe des Bytearrays fest.

ILockBytes::LockRegion

Diese Implementierung unterstützt keine Sperren, sodass dwLocksType auf 0 (null) festgelegt ist. Der Aufrufer muss sicherstellen, dass Zugriffe gültig sind und sich gegenseitig ausschließen.

ILockBytes::UnlockRegion

Diese Implementierung unterstützt keine Sperren.

ILockBytes::Stat

Die COM-bereitgestellte IStorage::Stat-Implementierung ruft die ILockBytes::Stat-Methode auf, um Daten über das 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