IMoniker インターフェイス (objidl.h)

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

COM オブジェクトを一意に識別する情報を含むモニカーオブジェクトを使用できます。モニカーオブジェクトの IMoniker インターフェイスへのポインターを持つオブジェクトは、オブジェクトが実際に分散システムに配置されている場所に関する他の特定の情報を持たずに、識別されたオブジェクトを検索、アクティブ化、およびアクセスできます。

モニカーは、COM でのリンクの基礎として使用されます。リンクオブジェクトには、そのソースを識別するモニカーが含まれています。ユーザーがリンクされたオブジェクトをアクティブにして編集すると、モニカーがバインドされます。これにより、リンクソースがメモリに読み込まれます。

継承

IMoniker インターフェイスは IPersistStream から継承されます。 IMoniker には、次の種類のメンバーもあります。

メソッド

IMoniker インターフェイスには、これらのメソッドがあります。


IMoniker::BindToObject 指定したオブジェクトにバインドします。バインディングプロセスでは、オブジェクトを見つけ、必要に応じて実行中の状態にし、識別されたオブジェクト上の指定されたインターフェイスへのポインターを呼び出し元に提供します。
IMoniker::BindToStorage 指定したオブジェクトのストレージにバインドします。 IMoniker::BindToObject メソッドとは異なり、このメソッドはモニカーによって識別されるオブジェクトをアクティブ化しません。
IMoniker::CommonPrefixWith このモニカーが指定したモニカーと共通するプレフィックスに基づいて、新しいモニカーを作成します。
IMoniker::ComposeWith 現在のモニカーと指定したモニカーを組み合わせて、新しい複合モニカーを作成します。
IMoniker::Enum 複合モニカーのコンポーネントの列挙子へのポインターを取得します。
IMoniker::GetDisplayName モニカーの表示名を取得します。
IMoniker::GetTimeOfLastChange このモニカーによって識別されたオブジェクトが最後に変更された時刻を取得します。
IMoniker::Hash モニカーの内部状態を使用してハッシュ値を作成します。
IMoniker::Inverse このモニカーの逆であるモニカーを作成します。このモニカーまたは同様の構造の 1 つの右側に構成されている場合、モニカーは何も作成しません。
IMoniker::IsEqual このモニカーが指定したモニカーと同じかどうかを判断します。
IMoniker::IsRunning このモニカーによって識別されたオブジェクトが現在読み込まれ、実行されているかどうかを判断します。
IMoniker::IsSystemMoniker このモニカーがシステム提供のモニカークラスの 1 つであるかどうかを判断します。
IMoniker::P arseDisplayName 表示名をモニカーに変換します。
IMoniker::Reduce モニカーを最も単純な形式に減らします。
IMoniker::RelativePathTo このモニカーと指定したモニカーの間に相対モニカーを作成します。

注釈

モニカーには、ファイルシステム内のファイルへのパスと同様に、COM オブジェクトを見つけてアクティブ化できるようにする情報が含まれています。モニカーは、ファイルに格納されているドキュメントオブジェクトから、埋め込みオブジェクト内の選択範囲まで、あらゆる種類の COM オブジェクトを識別できます。 COM には、システムで最も一般的に見られるオブジェクトを識別するモニカーオブジェクトを作成できるモニカークラスのセットが用意されています。たとえば、スプレッドシート内のセル範囲を表すオブジェクトがあり、それ自体がファイルに格納されているテキストドキュメントに埋め込まれている場合があります。分散システムでは、このオブジェクトのモニカーは、オブジェクトのシステムの場所、そのシステム上のファイルの物理的な場所、そのファイル内の埋め込みオブジェクトのストレージ、最後に埋め込みオブジェクト内のセル範囲の場所を識別します。

モニカーオブジェクトは、IPersistStream インターフェイスから派生し、システム内の 1 つのオブジェクトを一意に識別する IMoniker インターフェイスをサポートします。モニカーを提供するオブジェクトがモニカーオブジェクトを作成した後、そのオブジェクト内でこの情報を変更することはできません。モニカープロバイダーが情報を変更する場合は、新しいモニカーオブジェクトを作成することによってのみ行うことができます。これにより、該当するオブジェクトが一意に識別されます。

モニカーには、次の 2 つの重要な機能があります。

モニカーは永続ストレージに保存できます。モニカーをメモリに読み込み戻しても、同じオブジェクトが識別されます。
モニカーは binding と呼ばれる操作をサポートしています。これは、モニカーによって名前付けされたオブジェクトを検索し、アクティブになっていない場合はそれをアクティブにし (メモリに読み込む)、そのオブジェクトの要求されたインターフェイスへのポインターを返すプロセスです。

アンチモニカーの実装

アンチモニカーは、ファイル、項目、およびポインターモニカーの COM 実装の逆です。つまり、ファイルモニカー、アイテムモニカー、またはポインターモニカーの右側に構成されるアンチモニカーは、何も作成しません。

モニカークライアントの場合は、通常、アンチモニカーを使用する必要はありません。モニカーの逆関数が必要な場合は、 IMoniker::Inverse を呼び出す必要があります。たとえば、複合モニカーの最後の部分を削除するために逆関数が必要な場合は、 IMoniker::Enum を使用してモニカーの部分を列挙し、右端の部分で逆関数を呼び出します。この目的にはアンチモニカーを使用しないでください。これは、複合の最も適切な部分が反モニカーを逆と見なしていることを確認できないためです。

アンチモニカーを明示的に使用する必要がある唯一の状況は、新しいモニカークラスを記述していて、モニカーに逆関数を構築するための特別な要件がない場合です。その場合は、逆関数の実装からアンチモニカーを返すことができます。 IMoniker::ComposeWith の実装では、発生したすべての反モニカーに対してモニカーの 1 つを全滅させる必要があります。

CreateAntiMoniker 関数を使用して、これらのモニカーを作成します。

クラスモニカーの実装

クラスモニカーは、オブジェクトクラスを表すモニカーです。クラスモニカーは、作成対象のクラスのクラスオブジェクトにバインドされます。

クラスモニカーは、ファイルモニカーやアイテムモニカーなどの他の種類のモニカーとの合成に最も役立ちます。クラスモニカーは、 IClassActivator インターフェイスへのバインドをサポートするモニカーの右側にも構成できます。これにより、 IClassActivator は、クラスのクラスオブジェクトとインスタンスへのアクセスを提供できます。

クラスモニカーを使用するには、 CreateClassMoniker 関数を使用してこれらのモニカーを作成する必要があります。

ファイルモニカーの実装

ファイルモニカーは、ファイルシステム内のパスを表すモニカーです。ファイルモニカーは、独自のファイルに保存されている任意のオブジェクトを識別できます。ファイル内に含まれるオブジェクトを識別するために、ファイルモニカーの右側にある他のクラス (アイテムモニカーなど) のモニカーを作成できます。ただし、複合内のファイルモニカーの左側にあるモニカーは、別のファイルモニカー、アンチモニカー、またはクラスモニカーである必要があります。たとえば、複合内のファイルモニカーの左側にアイテムモニカーが表示される場合は無効です。

アンチモニカーは、モニカーが表すパスのコンポーネントの逆ではなく、ファイルモニカー全体の逆であることに注意してください。つまり、ファイルモニカーの右側にアンチモニカーを作成すると、ファイルモニカー全体が削除されます。ファイルモニカーによって表されるパスの右端のコンポーネントのみを削除する場合は、".." パスに基づいて別のファイルモニカーを作成し、ファイルモニカーの末尾まで作成する必要があります。

モニカークライアント (モニカーを使用してオブジェクトへのインターフェイスポインターを取得する) は、通常、モニカーのクラスを認識する必要はありません。 IMoniker インターフェイスポインターを使用してメソッドを呼び出すだけです。

モニカープロバイダー (モニカークライアントがアクセスできるようにオブジェクトを識別するモニカーを渡す) は、識別するオブジェクトがファイルに格納されている場合は、ファイルモニカーを使用する必要があります。各オブジェクトが独自のファイルに存在する場合、必要な型はファイルモニカーだけです。識別されたオブジェクトがファイルよりも小さい場合は、ファイルモニカーに加えて別の種類のモニカー (アイテムモニカーなど) を使用する必要があります。

ファイルモニカーを使用するには、 CreateFileMoniker 関数を使用してモニカーを作成する必要があります。ファイルモニカーがバインドされたときにオブジェクトを読み込むには、オブジェクトで IPersistFile インターフェイスを実装する必要があります。

モニカープロバイダーの最も一般的な例は、リンクをサポートする COM サーバーアプリケーションです。 COM サーバーアプリケーションがファイルベースのドキュメントへのリンクのみを完全にサポートしている場合、必要なモニカーの種類はファイルモニカーだけです。 COM サーバーアプリケーションで、ドキュメントよりも小さいオブジェクト (ドキュメントのセクションや埋め込みオブジェクトなど) へのリンクがサポートされている場合は、アイテムモニカーとファイルモニカーを使用する必要があります。

汎用複合モニカーの実装

ジェネリック複合モニカーは、コンポーネントが相互に特別な知識を持たない複合モニカーです。

コンポジションは、2つのモニカーを一緒に結合するプロセスです。場合によっては、特定のクラスの2つのモニカーを特別な方法で組み合わせることができます。たとえば、不完全なパスを表すファイルモニカーと、相対パスを表す別のファイルモニカーを組み合わせて、完全なパスを表す単一のファイルモニカーを形成できます。これは非ジェネリックコンポジションの例です。一方、ジェネリックコンポジションは、クラスに関係なく、任意の2つのモニカーを接続できます。非ジェネリックコンポジションは関係するモニカーのクラスに依存するため、 IMoniker::ComposeWith メソッドの特定のクラスの実装によってのみ実行できます。新しいモニカークラスを記述する場合は、新しい種類の非ジェネリックコンポジションを定義できます。これに対し、汎用コンポジションは CreateGenericComposite 関数によって実行されます。

モニカークライアント (モニカーを使用してオブジェクトへのインターフェイスポインターを取得する) は、通常、モニカーのクラス、または汎用複合または非ジェネリック複合のいずれであるかを知る必要はありません。 IMoniker インターフェイスポインターを使用してメソッドを呼び出すだけです。

モニカープロバイダー (モニカークライアントがアクセスできるようにオブジェクトを識別するモニカーを配布する) は、2 つのモニカーを一緒に作成する必要がある場合があります。 (たとえば、アイテムモニカーを使用してオブジェクトを識別する場合は、オブジェクトを渡す前に、そのオブジェクトのコンテナーを識別するモニカーを使用して作成する必要があります)。 IMoniker::ComposeWith メソッドを使用してこれを行い、最初のモニカーでメソッドを呼び出し、2 番目のモニカーをパラメーターとして渡します。このメソッドは、ジェネリックまたは非ジェネリック複合を生成できます。

ジェネリック複合モニカーを明示的に作成する必要があるのは、独自のモニカークラスを作成する場合だけです。 IMoniker::ComposeWith の実装では、可能な限り非一般的なコンポジションを実行する必要があります。非ジェネリックコンポジションを実行できず、ジェネリックコンポジションが許容される場合は、CreateGenericComposite 関数を呼び出してジェネリック複合モニカーを作成できます。

アイテムモニカーの実装

アイテムモニカーは、コンテナー内のオブジェクト (ドキュメントの一部、複合ドキュメント内の埋め込みオブジェクト、スプレッドシート内のセルの範囲など) を識別するために使用されます。アイテムモニカーは、多くの場合、ファイルモニカーと組み合わせて使用されます。ファイルモニカーはコンテナーを識別するために使用され、アイテムモニカーはコンテナー内の項目を識別するために使用されます。

アイテムモニカーにはテキスト文字列が含まれています。この文字列は、コンテナーオブジェクトによって、含まれている項目を他のアイテムと区別するために使用されます。コンテナーオブジェクトは、IOleItemContainer インターフェイスを実装する必要があります。このインターフェイスを使用すると、項目モニカーコードは、オブジェクトを識別する文字列のみを指定して、オブジェクトへのポインターを取得できます。

モニカークライアント (モニカーを使用してオブジェクトへのインターフェイスポインターを取得する) は、通常、モニカーのクラスを知る必要はありません。 IMoniker インターフェイスポインターを使用してメソッドを呼び出すだけです。

特定されたオブジェクトが別のオブジェクトに含まれていて、文字列を使用して個別に識別できる場合、モニカープロバイダー (モニカークライアントがオブジェクトを識別するモニカーを渡してモニカーにアクセスできるようにする) は、アイテムモニカーを使用する必要があります。コンテナーオブジェクトを識別するには、別の種類のモニカー (ファイルモニカーなど) を使用します。

アイテムモニカーを使用するには、 CreateItemMoniker 関数を使用してモニカーを作成する必要があります。項目モニカーがバインドされたときにオブジェクトを読み込むには、オブジェクトのコンテナーで IOleItemContainer インターフェイスを実装する必要があります。

モニカープロバイダーの最も一般的な例は、リンクをサポートする COM アプリケーションです。 COM アプリケーションでファイルベースのドキュメントよりも小さいオブジェクトへのリンクがサポートされている場合は、アイテムモニカーを使用する必要があります。文書内の選択範囲へのリンクを許可するサーバーアプリケーションの場合は、アイテムモニカーを使用してそれらのオブジェクトを識別します。埋め込みオブジェクトへのリンクを許可するコンテナーアプリケーションの場合は、項目モニカーを使用して埋め込みオブジェクトを識別します。

OBJREF モニカーの実装

OBJREF モニカーは、ローカルまたはリモートのアウトプロセスサーバーで実行されているオブジェクトインスタンスへの参照を表します。モニカーはオブジェクトインスタンスを識別し、オブジェクトが実行されているコンピューターを識別します。

OBJREF モニカーは、実行中のオブジェクトがアウトプロセスである点を除き、ポインターモニカーと多くの点で似ています。クライアントは、OBJREF モニカーで IMoniker::BindToObject を呼び出し、取得したポインターを使用して、場所に関係なく実行中のオブジェクトにアクセスできます。

ポインターモニカーとの重要な違いは、OBJREF モニカーの表示名を HTML ページに埋め込み、モニカーで表される実行中のオブジェクトをクライアントスクリプト、アプレット、または ActiveX コントロールでバインドできることです。

OBJREF モニカーの主な用途は、インターネット経由で実行中のオブジェクトインスタンスへのアクセスを取得することです。アクティブ・サーバー・ページまたは動的 HTML コンテンツを生成するその他の方法は、OBJREF モニカーの表示名をパラメーターにアプレットまたは ActiveX コントロールに配置します。アプレットまたはコントロールのコードは、CreateObjrefMoniker 関数を呼び出して、表示名に基づいて OBJREF モニカーを作成し、結果の OBJREF モニカーで IMoniker::BindToObject を呼び出して、実行中のオブジェクトインスタンスにアクセスします。次に、アクティブなサーバーページは、実行中のオブジェクトへのポインターをページのクライアントにマーシャリングします。

ポインターモニカーの実装

ポインターモニカーは基本的にインターフェイスポインターをラップしてモニカーのように見え、モニカーを必要とするインターフェイスに渡すことができます。ポインターモニカーのバインドは、ポインターの QueryInterface メソッドを呼び出すことによって行われます。

ポインターモニカーのインスタンスはシリアル化を拒否します。つまり、 IPersistStream::Save はエラーを返します。ただし、これらのモニカーは RPC 呼び出しで別のプロセスにマーシャリングできます。内部的には、システムは、インターフェイスポインターをマーシャリングするための標準パラダイムを使用して、ポインターをマーシャリングおよびアンマーシャリングします。

ポインターモニカーはほとんど必要ありません。ポインターモニカーは、永続的な表現を持たないオブジェクトを特定するためにモニカーが必要な場合にのみ使用します。ポインターモニカーを使用すると、このようなオブジェクトをモニカーバインド操作に参加できます。

URL モニカーの実装

IMoniker の URL モニカーの実装は、URL モニカーオブジェクトにあります。これは、IUnknown と IAsyncMoniker インターフェイスもサポートしています。 IMoniker インターフェイスは IPersistStream と IUnknown から定義を継承し、IPersistStream はIPersist から継承します。したがって、 IMoniker の実装には 、IPersistStream と IPersist のサポートが含まれています。

IAsyncMoniker インターフェイスは、単に IUnknown です。 (追加のメソッドはありません)。これは、モニカーが非同期バインディングをサポートしているかどうかをクライアントが判断できるようにするために使用されます。

このオブジェクトの IMoniker インターフェイスへのポインターを取得するには、 CreateURLMonikerEx 関数を呼び出します。

モニカークライアント (モニカーを使用してオブジェクトへのインターフェイスポインターを取得する) は、通常、使用しているモニカーのクラスを知る必要はありません。 IMoniker インターフェイスポインターを使用してメソッドを呼び出すだけです。

モニカープロバイダー (モニカークライアントがオブジェクトにアクセスできるようにオブジェクトを識別するモニカーを配布する) では、識別するオブジェクトが別のオブジェクトに含まれていて、文字列を使用して個別に識別できる場合は、アイテムモニカーを使用する必要があります。また、別の種類のモニカー (ファイルモニカーなど) を使用してコンテナーオブジェクトを識別する必要もあります。

要件

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