IDirectWriterLock::WaitForWriteAccess 方法 (objidl.h)

WaitForWriteAccess 方法获取对存储对象的独占写入访问权限。

语法

HRESULT WaitForWriteAccess(
  [in] DWORD dwTimeout
);

参数

[in] dwTimeout

指定此方法在等待获取对存储对象的独占写入访问权限时阻止的时间(以毫秒为单位)。 如果 dwTimeout 为零,则 方法不会阻止等待写入的独占访问。 允许 对 dwTimeout 使用平台 SDK 中定义的 INFINITE 超时。

返回值

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

返回代码 说明
S_OK 调用方已成功获得对存储的独占写入访问权限。
S_FALSE 再次调用此方法,而无需对 IDirectWriterLock::ReleaseWriteAccess 进行干预调用。
STG_E_INUSE 指定的超时在未获得独占写入访问权限的情况下过期。

注解

在直接模式下打开存储时, (STGM_DIRECT) STGM_READWRITE |STGM_SHARE_DENY_WRITE,可以调用此方法来获取对存储的独占写入访问权限。

如果没有打开存储的读取器,此方法将立即返回。 如果存储仍处于打开状态以供读取,则此方法会阻止指定的 dwTimeout 或 ,直到当前读取器关闭存储。

要求

要求
最低受支持的客户端 Windows 2000 专业版 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows 2000 Server [桌面应用 |UWP 应用]
目标平台 Windows
标头 objidl.h
Library Uuid.lib
DLL Ole32.dll

另请参阅

IDirectWriterLock::HaveWriteAccess

IDirectWriterLock::ReleaseWriteAccess