IOleLink：：SetUpdateOptions 方法 (oleidl.h)

發行項
03/01/2024

指定連結物件應該更新其快取數據的頻率。

語法

HRESULT SetUpdateOptions(
  [in] DWORD dwUpdateOpt
);

參數

[in] dwUpdateOpt

指定連結物件應該更新其快取數據的頻率。 dwUpdateOpt 的可能值取自列舉 OLEUPDATE。

傳回值

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

傳回碼	Description
E_INVALIDARG	提供的值無效。

備註

來電者的附註

當使用者變更連結物件的更新選項時，容器應用程式應該呼叫 IOleLink：：SetUpdateOptions 。

使用者會使用 [ 連結 ] 對話框，選取連結物件的更新選項。如果您使用 OleUIEditLinks 函式來顯示此對話框，則必須實作 IOleUILinkContainer 介面。對話框會呼叫您的 IOleUILinkContainer：：SetLinkUpdateOptions 方法來指定終端使用者所選擇的更新選項。此方法的實作應該呼叫 IOleLink：：SetUpdateOptions 方法，將選取的選項傳遞至連結的物件。

實作者的注意事項

默認更新選項OLEUDPATE_ALWAYS。鏈接物件的 IPersistStorage：：Save 實作會儲存目前的更新選項。

如果OLEUDPATE_ALWAYS指定為更新選項，連結物件會在下列情況下更新連結的快取：

當更新選項從手動變更為自動時，如果鏈接來源正在執行。
每當連結的物件系結至連結來源時。
每當連結來源執行且鏈接物件的 IOleObject：：Close、 IPersistStorage：：Save 或 IAdviseSink：：OnSave 實作呼叫時。

針對手動和自動連結，每當容器應用程式呼叫 IOleObject：：Update 或 IOleLink：：Update 時，鏈接的物件都會更新快取。

規格需求

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