共用方式為


IOleCacheControl::OnRun 方法 (oleidl.h)

通知快取數據源對象已進入執行中狀態,以便快取物件視需要建立建議接收。

語法

HRESULT OnRun(
  [in] LPDATAOBJECT pDataObject
);

參數

[in] pDataObject

進入執行狀態之物件的 IDataObject 介面指標。

傳回值

此方法會在成功時傳回S_OK。 其他可能的傳回值包括下列專案。

傳回碼 Description
E_INVALIDARG
其中一個自變數無效。
E_UNEXPECTED
已發生未預期的錯誤。
E_OUTOFMEMORY
此作業的記憶體不足。

備註

呼叫 OnRun 時,快取會視需要與源數據物件設定諮詢連線,以便接收通知。 呼叫 IOleCacheControl::OnStop 時,會在執行中物件與快取之間建立的諮詢連線終結。

某些物件處理程式或進程內伺服器可能會被動地使用快取,而不是呼叫 OnRun。 這些應用程式必須呼叫 IOleCache2::UpdateCacheIOleCache::InitCacheIOleCache::SetData ,以確保快取更新時填滿快取。

OnRun 不會在 pDataObject 中傳遞的 IDataObject 指標上新增參考計數。 由於 OleRun 的呼叫端負責確保 pDataObject 指標的存留期會持續到呼叫 OnStop 之前,呼叫端必須保留相關數據物件上 IDataObject 的指標。

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 oleidl.h

另請參閱

IOleCache2::UpdateCache

IOleCacheControl

IOleCacheControl::OnStop