IOleObject::GetMoniker メソッド (oleidl.h)

[アーティクル]
08/25/2023

呼び出し元がオブジェクトへのリンクに使用できる埋め込みオブジェクトのモニカーを取得します。

構文

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

パラメーター

[in] dwAssign

オブジェクトに対するモニカーの割り当て方法を決定します。 dwAssign の値に応じて、IOleObject::GetMoniker は次のいずれかを実行します。

モニカーが既に割り当てられている場合にのみ、モニカーを取得します。
呼び出しを満たすために、必要に応じてモニカーの割り当てを強制します。
一時的なモニカーを取得します。

dwAssign の値は、列挙 OLEGETMONIKER で指定されます。

メモIOleObject::GetMoniker を呼び出すときに OLEGETMONIKER_UNASSIGN を渡すことはできません。この値は、 IOleObject::GetMoniker を呼び出す場合にのみ有効です。

[in] dwWhichMoniker

要求するモニカーの形式を指定します。指定できる値は、列挙 OLEWHICHMK から取得されます。

[out] ppmk

オブジェクトのモニカーへのインターフェイスポインターを受け取る IMoniker ポインター変数のアドレス。エラーが発生した場合は、 ppmk を NULL に設定する必要があります。オブジェクトが IOleObject::GetMoniker の呼び出しを受け取るたびに、 ppmk の参照カウントを増やす必要があります。 ppmk で完了したら、Release を呼び出すのは呼び出し元の責任です。

戻り値

このメソッドは、成功したS_OKを返します。

注釈

IOleObject::GetMoniker メソッドは、オブジェクトのモニカーを返します。 IOleObject::SetMoniker と同様に、このメソッドは埋め込みオブジェクトへのリンクを管理するコンテキストでのみ重要であり、その場合でも省略可能です。オブジェクトのモニカーをオブジェクトにバインドする必要がある潜在的なリンククライアントは、このメソッドを呼び出して、そのモニカーを取得できます。 IOleObject::GetMoniker の既定の実装では、IOleClientSite::GetMoniker が呼び出され、オブジェクトが実行されていないか、クライアントサイトへの有効なポインターがない場合にE_UNEXPECTEDが返されます。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	oleidl.h