IOleObject::GetMoniker メソッド (oleidl.h)
呼び出し元がオブジェクトへのリンクに使用できる埋め込みオブジェクトのモニカーを取得します。
構文
HRESULT GetMoniker(
[in] DWORD dwAssign,
[in] DWORD dwWhichMoniker,
[out] IMoniker **ppmk
);
パラメーター
[in] dwAssign
オブジェクトに対するモニカーの割り当て方法を決定します。 dwAssign の値に応じて、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 |