IOleLink：：Update 方法 (oleidl.h)

發行項
03/01/2024

匯報連結物件的複合檔快取數據。如果連結來源尚未系結，這牽涉到系結至連結來源。

語法

HRESULT Update(
  [in] IBindCtx *pbc
);

參數

[in] pbc

系結內容上 IBindCtx 介面的指標，用於系結連結來源。此參數可以是 Null。系結內容會快取系結於系結程式期間系結的物件、包含使用系結內容套用至所有作業的參數，並提供系結實作應該擷取其環境相關信息的方法。如需詳細資訊，請參閱 IBindCtx。

傳回值

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

傳回碼	Description
CACHE_E_NOCACHE_UPDATE	系結作業已運作，但未更新任何快取。
CACHE_S_SOMECACHES_NOTUPDATED	系結作業已運作，但並非所有快取都已更新。
OLE_E_CANT_BINDTOSOURCE	無法繫結至連結來源。

備註

來電者附註

如果使用者更新連結物件的快取數據，您的容器應用程式應該呼叫 Update 。

終端使用者可以選擇 [連結] 對話方塊中的 [立即更新] 按鈕，以更新連結物件的快取數據。如果您使用 OleUIEditLinks 函式來顯示 [連結 ] 對話框，則必須實作 IOleUILinkContainer 介面。對話框會在用戶選擇 [立即更新] 按鈕時，呼叫 IOleUILinkContainer：：UpdateLink 的實作。該方法的實作可以呼叫 Update。

您的容器應用程式也可以呼叫 Update 來更新連結的物件，因為該方法會在連結物件上呼叫Update時呼叫 Update 。

這個方法會更新自動連結和手動連結。針對手動連結，呼叫 Update 或 Update 是更新快取的唯一方法。如需自動和手動連結的詳細資訊，請參閱 IOleLink：：SetUpdateOptions。

實作注意事項

如果其為非 NULL，則鏈接物件的 Update 實作會呼叫 IBindCtx：：RegisterObjectBound 來註冊系結連結來源。這可確保連結來源會繼續執行，直到釋放系結內容為止。

如果鏈接來源無法系結，則目前的快取會保持不變。

規格需求

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