IStream_UnlockRegion

UnlockRegion メソッドは、IStream::LockRegion で以前に制限されたバイト範囲のアクセス制限を削除する。

IStream_UnlockRegion this, libOffset, cb, dwLockType

this : [comobj] IStream インターフェースの COM オブジェクト変数
libOffset : [int64] 範囲の先頭のバイトオフセットを指定する。
cb : [int64] 制限する範囲の長さ (バイト単位) を指定する。
dwLockType : [int] 範囲に以前に設定されたアクセス制限を指定する。

(プラグイン / モジュール : com_misc.dll)

解説

UnlockRegion メソッドは、IStream::LockRegion で以前に制限されたバイト範囲のアクセス制限を削除する。

[戻り値]
このメソッドは次のいずれかの値を返す。 | リターンコード | 説明 |
|----------------|---------------| |S_OK | バイト範囲がロック解除された。|
|E_PENDING | 非同期ストレージのみ: ストリームのデータの一部または全部が現在利用できない。|
|STG_E_INVALIDFUNCTION | ロックがまったくサポートされないか、要求された特定のタイプのロックがサポートされない。|
|STG_E_LOCKVIOLATION | 要求されたロック解除操作を許可できない。| |STG_E_REVERTED |
トランザクションツリーの上位の revert 操作によりオブジェクトが無効化された。|

[備考]
IStream::UnlockRegion は、IStream::LockRegion
メソッドで以前にロックされた領域をロック解除する。ロックされた領域は、後で libOffset、cb、dwLockType
パラメータにまったく同じ値を指定して IStream::UnlockRegion
を呼び出して明示的にロック解除する必要がある。ストリームが解放される前に領域をロック解除する必要がある。隣接する 2
つの領域を別々にロックして、1 回のロック解除呼び出しでロック解除することはできない。

情報