ITextStoreAnchorSink::OnLockGranted 方法 (textstor.h)

调用 以授予文档锁定。

语法

HRESULT OnLockGranted(
  [in] DWORD dwLockFlags
);

参数

[in] dwLockFlags

包含一组标志,用于标识所请求的锁的类型和其他锁请求数据。 这可以是以下值之一。

含义
TS_LF_READ
锁是只读的。
TS_LF_READWRITE
锁是可读/写的。

返回值

此方法可以返回其中一个值。

说明
S_OK
方法成功。
E_INVALIDARG
dwLockFlags 无效。
E_UNEXPECTED
授予了错误的锁类型。

注解

通过调用 ITextStoreAnchor::RequestLock 请求文档锁。 应用程序使用请求的锁类型调用 ITextStoreAnchorSink::OnLockGranted 来授予锁定请求。 锁仅在 OnLockGranted 调用期间有效。 当 OnLockGranted 返回时,文档被视为已解锁。

在 dwLockFlags 中指定的锁类型必须与对 ITextStoreAnchor::RequestLock 的相应调用中请求的锁类型匹配。

OnLockGranted 内部调用 ITextStoreAnchor::RequestLock 将返回错误值。

应用程序不得从 OnLockGranted 上下文中调用任何 ITextStoreAnchorSink 方法。

如果从 ITextStoreAnchor::RequestLock 中发出同步锁请求,则调用方还必须提供 来自 ITextStoreAnchor::RequestLock 的返回值。

要求

要求
最低受支持的客户端 Windows 2000 专业版 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows 2000 Server [桌面应用 |UWP 应用]
目标平台 Windows
标头 textstor.h
DLL Msctf.dll
可再发行组件 Windows 2000 专业版上的 TSF 1.0

另请参阅

文档锁

ITextStoreAnchor::RequestLock

ITextStoreAnchorSink

TS_LF_* 常量