共用方式為

IOleUILinkContainerA：：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。 其他可能的傳回值包括下列專案。

傳回碼 Description
E_ACCESSDENIED
 訪問許可權不足。
E_FAIL
 作業失敗。
E_INVALIDARG
 指定的識別碼無效。
E_OUTOFMEMORY
 此作業的記憶體不足。

備註

來電者附註

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

實作者的注意事項

若為 OLE 連結，請呼叫 IOleObject：：Update。

規格需求

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

另請參閱

IOleObject：：Update

IOleUILinkContainer