IStream::UnlockRegion メソッド (objidl.h)

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

構文

HRESULT UnlockRegion(
  [in] ULARGE_INTEGER libOffset,
  [in] ULARGE_INTEGER cb,
  [in] DWORD          dwLockType
);

パラメーター

[in] libOffset

範囲の先頭のバイト オフセットを指定します。

[in] cb

制限する範囲の長さをバイト単位で指定します。

[in] dwLockType

以前に範囲に配置されたアクセス制限を指定します。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

リターン コード	説明
S_OK	バイト範囲がロック解除されました。
E_PENDING	非同期ストレージのみ: ストリームのデータの一部またはすべてを現在使用できません。
STG_E_INVALIDFUNCTION	ロックはまったくサポートされていないか、要求された特定の種類のロックがサポートされていません。
STG_E_LOCKVIOLATION	要求されたロック解除操作を許可できません。
STG_E_REVERTED	オブジェクトは、トランザクション ツリー内のオブジェクトの上にある元に戻す操作によって無効になっています。

解説

IStream::UnlockRegion は、以前に IStream::LockRegion メソッドでロックされていたリージョンのロックを解除します。 ロックされたリージョンは、後で libOffset、cb、dwLockType パラメーターとまったく同じ値で IStream::UnlockRegion を呼び出すことによって、明示的にロック解除する必要があります。 ストリームが解放される前に、リージョンのロックを解除する必要があります。 隣接する 2 つのリージョンを個別にロックしてから、1 回のロック解除呼び出しでロックを解除することはできません。

要件

サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	objidl.h
Library	Uuid.lib
[DLL]	Ole32.dll

関連項目

IStream - 複合ファイルの実装

IStream::LockRegion

Locktype