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 |