ILockBytes – Globale Speicherimplementierung
Die implementierung des globalen ILockBytes-Speichers wird in einem Bytearrayobjekt implementiert, das einem COM-Verbunddateispeicherobjekt zugrunde liegt, und ist für das direkte Lesen und Schreiben in den globalen Speicher konzipiert.
Verwendung
Methoden von ILockBytes werden von den Verbunddateiimplementierungen von IStorage und IStream für das Verbunddateispeicherobjekt aufgerufen, das durch einen Aufruf von StgCreateDocfile erstellt wurde.
Hinweise
Im Folgenden finden Sie die Methoden der globalen ILockBytes-Speicherimplementierung.
-
ILockBytes::ReadAt
-
Liest einen Byteblock 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 die Zugriffe gültig sind und sich gegenseitig ausschließen.
-
ILockBytes::UnlockRegion
-
Diese Implementierung unterstützt keine Sperren.
-
ILockBytes::Stat
-
Die von COM bereitgestellte IStorage::Stat-Implementierung ruft die ILockBytes::Stat-Methode auf, um Daten über das Bytearrayobjekt abzurufen. Wenn kein angemessener Name für das Bytearray vorhanden ist, gibt die von COM bereitgestellte ILockBytes::Stat-Methode NULL im pwcsName-Member der STATSTG-Struktur zurück.