ILockBytes – Globale Speicherimplementierung
Die globale ILockBytes-Speicherimplementierung wird in einem Bytearrayobjekt implementiert, das einem COM-Verbunddateispeicherobjekt zugrunde liegt, und für das direkte Lesen und Schreiben in den globalen Speicher konzipiert.
Wann verwendet werden soll
Methoden von ILockBytes werden aus den zusammengesetzten Dateiimplementierungen von IStorage und IStream- für das verbunddateispeicherobjekt aufgerufen, das über einen Aufruf von StgCreateDocfileerstellt wurde.
Bemerkungen
Im Folgenden sind die Methoden der ILockBytes globalen Speicherimplementierung aufgeführt.
-
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 Auswirkung.
-
ILockBytes::SetSize
-
Legt die Größe des Bytearrays fest.
-
ILockBytes::LockRegion
-
Diese Implementierung unterstützt keine Sperrung, sodass dwLocksType- auf Null festgelegt ist. Der Aufrufer muss sicherstellen, dass Zugriffe gültig und sich gegenseitig ausschließen.
-
ILockBytes::UnlockRegion
-
Diese Implementierung unterstützt keine Sperrung.
-
ILockBytes::Stat
-
Die von 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-Methode NULL- im pwcsName-element der STATSTG--Struktur zurück.
Verwandte Themen