ILockBytes – File-Based Implementierung
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.
Zugehörige Themen