IByteBuffer::UnlockRegion メソッド
[ UnlockRegion メソッドは、[要件] セクションで指定したオペレーティング システムで使用できます。 Windows Server 2003 Service Pack 1 (SP1) 以降、Windows Vista、Windows Server 2008、および以降のバージョンのオペレーティング システムでは使用できません。 IStream インターフェイスも同様の機能を提供します。
UnlockRegion メソッドは、IByteBuffer::LockRegion を使用して以前に制限されていたバイト範囲に対するアクセス制限を削除します。
構文
HRESULT UnlockRegion(
[in] LONG libOffset,
[in] LONG cb,
[in] LONG dwLockType
);
パラメーター
-
libOffset [in]
-
範囲の先頭のバイト オフセット。
-
cb [in]
-
制限する範囲の長さ (バイト単位)。
-
dwLockType [in]
-
以前に範囲に配置されたアクセス制限。
戻り値
戻り値は HRESULT です。 S_OK の値は、呼び出しが成功したことを示します。
解説
IByteBuffer::UnlockRegion メソッドは、IByteBuffer::LockRegion メソッドを使用して以前にロックされた領域のロックを解除します。 ロックされたリージョンは、後で libOffset、cb、dwLockType パラメーターとまったく同じ値で IByteBuffer::UnlockRegion を呼び出すことによって、明示的にロック解除する必要があります。 ストリームが解放される前に、リージョンのロックを解除する必要があります。 隣接する 2 つのリージョンを個別にロックしてから、1 回のロック解除呼び出しでロックを解除することはできません。
例
次の例は、バイト範囲のロック解除を示しています。
HRESULT hr;
// Unlock a region.
hr = pIByteBuff->UnlockRegion(0, 10, LOCK_EXCLUSIVE);
if (FAILED(hr))
printf("Failed IByteBuffer::UnlockRegion\n");
必要条件
要件 | 値 |
---|---|
サポートされている最小のクライアント |
Windows XP [デスクトップ アプリのみ] |
サポートされている最小のサーバー |
Windows Server 2003 [デスクトップ アプリのみ] |
クライアント サポートの終了 |
Windows XP |
サーバー サポートの終了 |
Windows Server 2003 |
Header |
|
タイプ ライブラリ |
|
[DLL] |
|
IID |
IID_IByteBufferは E126F8FE-A7AF-11D0-B88A-00C04FD424B9 として定義されています |