IOleLink::GetSourceMoniker 方法 (oleidl.h)
擷取識別連結化物件之連結來源的 Moniker。
語法
HRESULT GetSourceMoniker(
[out] IMoniker **ppmk
);
參數
[out] ppmk
IMoniker指標變數的位址,該變數會接收識別連結來源的絕對 Moniker 介面指標。 成功時,實作必須在ppmk上呼叫AddRef;呼叫者必須負責呼叫Release。 如果發生錯誤,實作必須將 ppmk 設定為 Null。
傳回值
此方法會在成功時傳回S_OK。 其他可能的傳回值包括下列專案。
傳回碼 | 描述 |
---|---|
|
沒有 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::GetSourceMoniker 或 IOleLink::GetSourceDisplayName 來變更絕對 Moniker。 此外,每當連結化物件成功系結至連結來源或系結至連結來源時,連結化物件就會自動更新 Monikers,並透過 IAdviseSink::OnRename 方法接收重新命名通知。
需求
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | oleidl.h |