IOleLink::GetSourceMoniker 方法 (oleidl.h)

擷取識別連結化物件之連結來源的 Moniker。

語法

HRESULT GetSourceMoniker(
  [out] IMoniker **ppmk
);

參數

[out] ppmk

IMoniker指標變數的位址,該變數會接收識別連結來源的絕對 Moniker 介面指標。 成功時,實作必須在ppmk上呼叫AddRef;呼叫者必須負責呼叫Release。 如果發生錯誤,實作必須將 ppmk 設定為 Null

傳回值

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

傳回碼 描述
MK_E_UNAVAILABLE
沒有 Moniker 可用。

備註

來電者的附注

您的容器應用程式可以呼叫 IOleLink::GetSourceMoniker ,在 [ 連結 ] 對話方塊中顯示連結的目前來源。 請注意,這需要您的容器使用 IMoniker::GetDisplayName 方法來取得 Moniker 的顯示名稱。 如果您想要直接取得顯示名稱,您的容器可以呼叫 IOleLink::GetSourceDisplayName ,而不是 IOleLink::GetSourceMoniker

如果您使用 OleUIEditLinks 函式來顯示 [ 連結 ] 對話方塊,則必須實作 IOleUILinkContainer 介面。 對話方塊會呼叫 IOleUILinkContainer::GetLinkSource 的實作,以取得它應該顯示的字串。 該方法的實作可以呼叫 IOleLink::GetSourceMoniker

實作者的注意事項

連結的物件會儲存連結來源的絕對和相對 Moniker。 如果相對 Moniker 為非Null ,且複合檔案可以使用 Moniker, 則 IOleLink::GetSourceMoniker 會傳回由將相對 Moniker 撰寫至複合檔案 Moniker 結尾所建立的 Moniker。 否則,它會傳回絕對 Moniker;如果發生錯誤,則傳回 Null

容器會在呼叫其中一個 OleCreateLink 函式來建立連結時,指定絕對 Moniker。 應用程式可以呼叫 IOleLink::GetSourceMonikerIOleLink::GetSourceDisplayName 來變更絕對 Moniker。 此外,每當連結化物件成功系結至連結來源或系結至連結來源時,連結化物件就會自動更新 Monikers,並透過 IAdviseSink::OnRename 方法接收重新命名通知。

需求

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

另請參閱

IOleLink

IOleLink::GetSourceDisplayName

IOleLink::GetSourceMoniker