IGlobalInterfaceTable

プロセス内の任意のアパートメントから、同一プロセス内の別のアパートメントにあるオブジェクトに実装されたインターフェイスへアクセスできるようにします。

IGlobalInterfaceTable インターフェイスは、プロセス全体で共有される変数や、他のオブジェクトへのインターフェイスポインターを保持するアジャイル(free-threaded marshaled)オブジェクトなど、プロセス内の複数のアパートメントからアクセス可能なメモリ位置にインターフェイスポインターを格納するための効率的な手段です。

アジャイルオブジェクトは、それが動作している基盤の COM インフラストラクチャ、つまりどのアパートメント、コンテキスト、スレッドで実行されているかを認識しません。このオブジェクトは、特定のアパートメントやコンテキストに固有のインターフェイスを保持している場合があります。そのため、アジャイルコンポーネントが実行されている場所からこれらのインターフェイスを呼び出しても、常に正しく動作するとは限りません。global interface table は、アジャイルオブジェクトが実行されている場所に基づいて、有効なプロキシ(または直接ポインター)がオブジェクトに対して使用されることを保証することで、この問題を回避します。

global interface table はプロセスやマシンの境界を越えて移送できないため、通常のパラメーター受け渡しの仕組みの代わりに使用することはできません。

プロセスの一つのアパートメントに存在するオブジェクト上の指定されたインターフェイスをグローバルインターフェイスとして登録し、他のアパートメントからそのインターフェイスへアクセスできるようにします。

このメソッドは次の値を返すことがあります。

オブジェクトが存在するアパートメント内で呼び出し、そのオブジェクトのインターフェイスの一つをグローバルインターフェイスとして登録します。このメソッドは cookie へのポインターを提供し、他のアパートメントはその cookie を GetInterfaceFromGlobal メソッドの呼び出しで使用して、そのインターフェイスへのポインターを取得できます。

インターフェイスポインターは、インプロセスオブジェクトへのポインターの場合もあれば、別のアパートメント、別のプロセス、または別のコンピューターに存在するオブジェクトのプロキシへのポインターの場合もあります。

このメソッドを呼び出したアパートメントは、対応する RevokeInterfaceFromGlobal の呼び出しまで存続している必要があります。

global interface table 内のインターフェイスの登録を取り消します。

このメソッドは次の値を返すことがあります。

global interface table オブジェクトに登録されたインターフェイスが、同一プロセス内の他のアパートメントからアクセスされる必要がなくなったときに、このメソッドを呼び出します。このメソッドは、global interface table にインターフェイスを登録したアパートメント以外を含め、プロセス内の任意のアパートメントから呼び出すことができます。

呼び出し元のアパートメントが使用できる、オブジェクト上のインターフェイスへのポインターを取得します。このインターフェイスは、現在 global interface table に登録されている必要があります。

このメソッドは次の値を返すことがあります。

インターフェイスが global interface table に登録された後、アパートメントは提供された cookie を指定して GetInterfaceFromGlobal メソッドを呼び出すことで、このインターフェイスへのポインターを取得できます。このインターフェイスへのポインターは呼び出し元のアパートメントで使用できますが、プロセス内の他のアパートメントでは使用できません。

アプリケーションは、IGlobalInterfaceTable::RevokeInterfaceFromGlobal の呼び出し中に、グローバル変数へのアクセスを調整する責任があります。つまり、あるスレッドが同じ cookie で GetInterfaceFromGlobal を呼び出している間に、別のスレッドが RevokeInterfaceFromGlobal を呼び出さないようにする必要があります。同じ cookie に対して GetInterfaceFromGlobal を複数回呼び出すことは許可されています。

GetInterfaceFromGlobal メソッドは、ppv パラメーターで取得したポインターに対して AddRef を呼び出します。このポインターに対して Release を呼び出すのは、呼び出し元の責任です。