ILockBytes – Globale Speicherimplementierung
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.
Zugehörige Themen