IDirectWriterLock::WaitForWriteAccess 方法 (objidl.h)

WaitForWriteAccess 方法會取得記憶體對象的獨佔寫入許可權。

語法

HRESULT WaitForWriteAccess(
  [in] DWORD dwTimeout
);

參數

[in] dwTimeout

指定這個方法在等候取得記憶體對象的獨佔寫入存取權時所封鎖的時間,以毫秒為單位。 如果 dwTimeout 為零,則方法不會封鎖等候獨佔存取權進行寫入。 dwTimeout 允許 Platform 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
程式庫 Uuid.lib
Dll Ole32.dll

另請參閱

IDirectWriterLock::HaveWriteAccess

IDirectWriterLock::ReleaseWriteAccess