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方法解除鎖定先前鎖定的區域。 鎖定的區域稍後必須透過呼叫 IByteBuffer::UnlockRegion 與 libOffset、 cb和 dwLockType 參數完全相同的值來明確解除鎖定。 必須先解除鎖定區域,才能釋放資料流程。 無法個別鎖定兩個相鄰區域,然後使用單一解除鎖定呼叫解除鎖定。
範例
下列範例顯示解除鎖定位元組範圍。
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 |
標頭 |
|
類型程式庫 |
|
DLL |
|
IID |
IID_IByteBuffer定義為 E126F8FE-A7AF-11D0-B88A-00C04FD424B9 |