共用方式為


IOleObject::GetMoniker 方法 (oleidl.h)

擷取內嵌物件的Moniker,呼叫端可用來連結至物件。

語法

HRESULT GetMoniker(
  [in]  DWORD    dwAssign,
  [in]  DWORD    dwWhichMoniker,
  [out] IMoniker **ppmk
);

參數

[in] dwAssign

決定如何將 Moniker 指派給物件。 根據 dwAssign 的值, IOleObject::GetMoniker 會執行下列其中一項:

  • 只有在已指派Moniker時,才會取得Moniker。
  • 視需要強制指派Moniker,以滿足呼叫。
  • 取得暫時的Moniker。
dwAssign 的值是在列舉 OLEGETMONIKER 中指定。
注意呼叫 IOleObject::GetMoniker 時,您無法傳遞 OLEGETMONIKER_UNASSIGN。 只有在呼叫 IOleObject::GetMoniker 時,這個值才有效。
 

[in] dwWhichMoniker

指定正在要求之 Moniker 的表單。 可能的值取自列舉 OLEWHICHMK

[out] ppmk

接收物件Moniker介面指標的 IMoniker 指標變數位址。 如果發生錯誤, ppmk 必須設定為 NULL。 每次物件收到 IOleObject::GetMoniker 的呼叫時,都必須增加 ppmk 上的參考計數。 呼叫者負責在 ppmk 完成時呼叫 Release。

傳回值

此方法會在成功時傳回S_OK。

備註

IOleObject::GetMoniker 方法會傳回物件的 Moniker。 就像 IOleObject::SetMoniker 一樣,這個方法只有在管理內嵌對象連結的內容中才重要,即使是在該情況下也是選擇性的。 需要物件的Moniker系結至對象的潛在連結用戶端可以呼叫這個方法來取得該Moniker。 IOleObject::GetMoniker 的預設實作會呼叫 IOleClientSite::GetMoniker,如果物件未執行或沒有用戶端月臺的有效指標,則會傳回E_UNEXPECTED。

規格需求

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

另請參閱

CreateItemMoniker

IOleClientSite::GetMoniker

IOleObject

IOleObject::SetMoniker

OLEGETMONIKER

OLEWHICHMK