ILockBytes – File-Based Implementierung

Implementiert für ein Bytearrayobjekt, das einem COM-Verbunddateispeicherobjekt zugrunde liegt, und wurde entwickelt, um direkt in eine Datenträgerdatei zu lesen und zu schreiben.

Wann verwendet werden soll

Methoden von ILockBytes werden aus den zusammengesetzten Dateiimplementierungen von IStorage und IStream- für das zusammengesetzte Dateispeicherobjekt aufgerufen, das über 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 Byteblock 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 internen Puffer, die vom ILockBytes Implementierung verwaltet werden, 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 Bereiche zugelassen oder eingeschränkt wird.

ILockBytes::UnlockRegion

Diese Methode entsperrt den durch ILockBytes::LockRegiongesperrten Bereich.

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-Methode NULL- im pwcsName-element der STATSTG--Struktur zurück.

Verwandte Themen

ILockBytes-

IStorage-

IStream-