共用方式為


IOleLink::Update 方法 (oleidl.h)

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

語法

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

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

實作注意事項

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

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

規格需求

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

另請參閱

IBindCtx::RegisterObjectBound

IOleLink

IOleLink::SetUpdateOptions

IOleLink::Update

IOleUILinkContainer

OleUIEditLinks