IOleLink::Update 方法 (oleidl.h)
匯報 連結物件的複合檔快取數據。 如果連結來源尚未系結,這牽涉到系結至連結來源。
語法
HRESULT Update(
[in] IBindCtx *pbc
);
參數
[in] pbc
系結內容上 IBindCtx 介面的指標,用於系結連結來源。 此參數可以是 Null。 系結內容會快取系結於系結程式期間系結的物件、包含使用系結內容套用至所有作業的參數,並提供系結實作應該擷取其環境相關信息的方法。 如需詳細資訊,請參閱 IBindCtx。
傳回值
此方法會在成功時傳回S_OK。 其他可能的傳回值包括下列專案。
傳回碼 | Description |
---|---|
|
系結作業已運作,但未更新任何快取。 |
|
系結作業已運作,但並非所有快取都已更新。 |
|
無法繫結至連結來源。 |
備註
來電者附註
如果使用者更新連結物件的快取數據,您的容器應用程式應該呼叫 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 |