IStream::UnlockRegion 方法 (objidl.h)
UnlockRegion 方法删除对以前使用 IStream::LockRegion 限制的字节范围的访问限制。
语法
HRESULT UnlockRegion(
[in] ULARGE_INTEGER libOffset,
[in] ULARGE_INTEGER cb,
[in] DWORD dwLockType
);
parameters
[in] libOffset
指定范围开头的字节偏移量。
[in] cb
指定要限制的范围长度(以字节为单位)。
[in] dwLockType
指定以前对范围施加的访问限制。
返回值
此方法可以返回其中一个值。
返回代码 | 说明 |
---|---|
S_OK | 字节范围已解锁。 |
E_PENDING | 仅异步存储:部分或全部流数据当前不可用。 |
STG_E_INVALIDFUNCTION | 完全不支持锁定,或者不支持请求的特定类型的锁。 |
STG_E_LOCKVIOLATION | 无法授予请求的解锁操作。 |
STG_E_REVERTED | 对象在事务树中的上方还原操作已失效。 |
注解
IStream::UnlockRegion 解锁以前使用 IStream::LockRegion 方法锁定的区域。 稍后,必须通过调用 IStream::UnlockRegion 来显式解锁锁定的区域,并且 libOffset、 cb 和 dwLockType 参数的值完全相同。 必须先解锁该区域,然后才能释放流。 无法单独锁定两个相邻区域,然后通过单个解锁调用解锁。
要求
最低受支持的客户端 | Windows 2000 专业版 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows 2000 Server [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | objidl.h |
Library | Uuid.lib |
DLL | Ole32.dll |