ILockBytes - File-Based実装

COM 複合ファイルストレージオブジェクトの基になるバイト配列オブジェクトに実装され、ディスクファイルに対して直接読み取りと書き込みを行うように設計されています。

使用するタイミング

ILockBytes のメソッドは、StgCreateDocfile の呼び出しによって作成された複合ファイルストレージオブジェクトの IStorage と IStream の複合ファイル実装から呼び出されるため、それらを直接呼び出す必要はありません。

ILockBytes File-Based Implementation のメソッドを次に示します。

ILockBytes::ReadAt: バイト配列の先頭にある指定されたオフセットからバイトブロックを読み取ります。
ILockBytes::WriteAt: バイト配列の先頭にある指定したオフセットからバイトブロックを書き込みます。
ILockBytes::Flush: ILockBytes 実装によって維持される内部バッファーが、基になる物理ストレージに確実に書き込まれます。
ILockBytes::SetSize: バイト配列のサイズを設定します。
ILockBytes::LockRegion: dwLockTypes パラメーターは LOCK_ONLYONCE または LOCK_EXCLUSIVE に設定され、ロックされたリージョンへのアクセスが許可または制限されます。
ILockBytes::UnlockRegion: このメソッドは、 ILockBytes::LockRegion によってロックされている領域のロックを解除します。
ILockBytes::Stat: COM 提供の IStorage::Stat 実装では 、ILockBytes::Stat メソッドを呼び出してバイト配列オブジェクトに関する情報を取得します。バイト配列に適切な名前がない場合、COM 提供の ILockBytes::Stat メソッドは STATSTG 構造体の pwcsName メンバーで NULL を返します。