ILockBytes::UnlockRegion 方法 (objidl.h)

UnlockRegion 方法會移除先前鎖定位元組範圍的存取限制。

語法

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

參數

[in] libOffset

指定範圍開頭的位元組位移。

[in] cb

指定限制的範圍長度,以位元組為單位。

[in] dwLockType

指定先前放在範圍上的存取限制類型。 此參數使用 LOCKTYPE 列舉中的值。

傳回值

這個方法可以傳回下列其中一個值。

傳回碼 描述
S_OK 位元組範圍已解除鎖定。
STG_E_INVALIDFUNCTION 完全不支援鎖定,或不支援所要求的特定鎖定類型。
STG_E_LOCKVIOLATION 無法授與要求的解除鎖定。

備註

ILockBytes::UnlockRegion 會解除鎖定先前使用 ILockBytes::LockRegion 呼叫鎖定的區域。 每個鎖定的區域都必須明確解除鎖定,使用與 ILockBytes::LockRegion 相符呼叫相同的 libOffsetcbdwLockType 參數值。 無法個別鎖定兩個相鄰區域,然後使用單一解除鎖定呼叫解除鎖定。

規格需求

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

另請參閱

ILockBytes - File-Based 實作

ILockBytes - 全域記憶體實作

ILockBytes::LockRegion

LOCKTYPE