共用方式為

IOleUILinkContainerW：：UpdateLink 方法 (oledlg.h)

  • 發行項

強制選取的連結連線到其來源並擷取目前的資訊。

語法

HRESULT UpdateLink(
  [in] DWORD dwLink,
  [in] BOOL  fErrorMessage,
  [in] BOOL  fReserved
);

參數

[in] dwLink

單一連結的容器定義唯一識別碼。 容器可以使用連結容器網站的指標來取得此值。

[in] fErrorMessage

判斷呼叫端 (IOleUILinkContainer) 的實作者是否應該在更新連結失敗時顯示錯誤訊息。 [ 更新連結 ] 對話方塊會將此設定為 FALSE。 [ 物件屬性 及 連結] 對話方塊將它設定為 TRUE。

[in] fReserved

此參數是保留的，而且必須設定為 FALSE。

傳回值

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

傳回碼 描述
E_ACCESSDENIED
 存取權限不足。
E_FAIL
 作業失敗。
E_INVALIDARG
 指定的識別碼無效。
E_OUTOFMEMORY
 此作業的記憶體不足。

備註

來電者的附注

在使用者快速按下按鈕以更新連結的情況下，呼叫這個方法，其中 fErrorMessage 設定為 TRUE ，也就是按下連結的 [ 立即更新 ] 按鈕。 如果容器不應該顯示錯誤訊息，也就是執行大量作業，而且稍後應該將錯誤傳播回使用者，如更新連結進度表可能發生的情況，請使用FALSE呼叫它。 如果發生失敗，而不是為每個失敗提供一則訊息，請在作業結束時提供所有失敗的單一訊息。

實作者的注意事項

針對 OLE 連結，呼叫 IOleObject：：Update。

需求

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

另請參閱

IOleObject：：Update

IOleUILinkContainer