IOleObject：：GetMoniker 方法 (oleidl.h)

發行項
03/05/2024

擷取內嵌物件的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