共用方式為

IOleUILinkContainerW：：SetLinkSource 方法 (oledlg.h)

  • 發行項

變更連結的來源。

語法

HRESULT SetLinkSource(
  [in]  DWORD  dwLink,
  [in]  LPWSTR lpszDisplayName,
  [in]  ULONG  lenFileName,
  [out] ULONG  *pchEaten,
  [in]  BOOL   fValidateSource
);

參數

[in] dwLink

單一連結的容器定義唯一標識碼。 請參閱 IOleUILinkContainer：：GetNextLink。

[in] lpszDisplayName

要剖析之新來源字串的指標。

[in] lenFileName

lpszDisplayName 字串前置檔名部分的長度。 如果連結來源未儲存在檔案中， 則 lenFileName 應該是 0。 針對 OLE 連結，請呼叫 IOleLink：：GetSourceDisplayName。

[out] pchEaten

成功剖析 lpszDisplayName 中字元數的指標。

[in] fValidateSource

如果應該驗證Moniker，則為TRUE;針對 OLE 連結，應該呼叫 MkParseDisplayName。 如果 不應該驗證Moniker，則為 FALSE。 可能的話，鏈接應該接受未驗證的來源，並將本身標示為無法使用。

傳回值

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

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

備註

來電者的附註

從 [ 變更來源] 對話框呼叫這個方法，並一開始將 fValidateSource 設定為 TRUE。 您可以直接或從 [連結] 對話框呼叫變更來源。 如果對 IOleUILinkContainer：：SetLinkSource 的呼叫傳回錯誤 (例如 MkParseDisplayName 失敗，因為來源無法使用) ，則您應該顯示 無效的連結來源 訊息，而且應該允許使用者決定是否要修正來源。 如果使用者選擇修正來源，則應該將用戶傳回 [ 變更來源 ] 對話框，並醒目提示輸入字串的無效部分。 如果使用者選擇不修正來源，則應該第二次呼叫 IOleUILinkContainer：：SetLinkSource ， 並將 fValidateSource 設定為 FALSE，而且使用者應該傳回 [ 連結 ] 對話框，且鏈接標示為 [無法使用]。

規格需求

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

另請參閱

IOleUILinkContainer

MkParseDisplayName