IOleCacheControl::OnRun 方法 (oleidl.h)
通知快取數據源對象已進入執行中狀態,以便快取物件視需要建立建議接收。
語法
HRESULT OnRun(
[in] LPDATAOBJECT pDataObject
);
參數
[in] pDataObject
進入執行狀態之物件的 IDataObject 介面指標。
傳回值
此方法會在成功時傳回S_OK。 其他可能的傳回值包括下列專案。
傳回碼 | Description |
---|---|
|
其中一個自變數無效。 |
|
已發生未預期的錯誤。 |
|
此作業的記憶體不足。 |
備註
呼叫 OnRun 時,快取會視需要與源數據物件設定諮詢連線,以便接收通知。 呼叫 IOleCacheControl::OnStop 時,會在執行中物件與快取之間建立的諮詢連線終結。
某些物件處理程式或進程內伺服器可能會被動地使用快取,而不是呼叫 OnRun。 這些應用程式必須呼叫 IOleCache2::UpdateCache、 IOleCache::InitCache 或 IOleCache::SetData ,以確保快取更新時填滿快取。
OnRun 不會在 pDataObject 中傳遞的 IDataObject 指標上新增參考計數。 由於 OleRun 的呼叫端負責確保 pDataObject 指標的存留期會持續到呼叫 OnStop 之前,呼叫端必須保留相關數據物件上 IDataObject 的指標。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | oleidl.h |