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 方法鎖定 的區域。 稍後必須明確解除鎖定區域,方法是呼叫 IStream::UnlockRegionlibOffsetcbdwLockType 參數完全相同的值。 必須先解除鎖定區域,才能釋放資料流程。 無法個別鎖定兩個相鄰區域,然後使用單一解除鎖定呼叫解除鎖定。

需求

   
最低支援的用戶端 Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows 2000 Server [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 objidl.h
程式庫 Uuid.lib
Dll Ole32.dll

另請參閱

IStream - 複合檔案實作

IStream::LockRegion

LOCKTYPE