ILockBytes - File-Based 実装
COM 複合ファイル ストレージ オブジェクトの基になるバイト配列オブジェクトに実装され、ディスク ファイルに対して直接読み取りと書き込みを行うように設計されています。
使用するタイミング
ILockBytes のメソッドは、IStorage の複合ファイル実装から呼び出され、StgCreateDocfileの呼び出しによって作成された複合ファイル ストレージ オブジェクトに対する 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 を返します。
関連トピック