ILockBytes - グローバルメモリ実装

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

使用するタイミング

ILockBytes のメソッドは、StgCreateDocfileの呼び出しによって作成された複合ファイルストレージオブジェクト IStorage およびIStream の複合ファイル実装から呼び出されます。

ILockBytes グローバルメモリ実装のメソッドを次に示します。

ILockBytes::ReadAt: バイト配列の先頭にある指定したオフセットからバイトブロックを読み取ります。
ILockBytes::WriteAt: バイト配列の先頭にある指定したオフセットからバイトブロックを書き込みます。
ILockBytes::Flush: ファイルベースの実装とは異なり、グローバルメモリ実装でこのメソッドを呼び出しても効果はありません。
ILockBytes::SetSize: バイト配列のサイズを設定します。
ILockBytes::LockRegion: この実装ではロックがサポートされていないため、dwLocksType 0 に設定されます。呼び出し元は、アクセスが有効であり、相互に排他的であることを確認する必要があります。
ILockBytes::UnlockRegion: この実装では、ロックはサポートされていません。
ILockBytes::Stat: COM 提供の IStorage::Stat 実装は、ILockBytes::Stat メソッドを呼び出して、バイト配列オブジェクトに関するデータを取得します。バイト配列に適切な名前がない場合、COM 提供の ILockBytes::Stat メソッドは、STATSTG 構造体の pwcsName メンバーで NULL を返します。