アクティブ化コンテキスト API の使用

[アーティクル]
05/11/2022

アプリケーションは、アクティブ化コンテキスト関数を直接呼び出すことによって、アクティブ化コンテキストを管理できます。アクティブ化コンテキストは、メモリ内のデータ構造です。システムは、アクティブ化コンテキストの情報を使用して、特定の DLL バージョン、COM オブジェクトインスタンス、またはカスタムウィンドウバージョンを読み込むようにアプリケーションをリダイレクトできます。詳細については、「アクティブ化コンテキストリファレンス」を参照してください。

アプリケーションプログラミングインターフェイス (API) を使用して、アクティブ化コンテキストを管理し、マニフェストを含むバージョン名のオブジェクトを作成できます。次の 2 つのシナリオは、アプリケーションがアクティブ化コンテキスト関数を直接呼び出すことによってアクティブ化コンテキストを管理する方法を示しています。ただし、ほとんどの場合、アクティブ化コンテキストはシステムによって管理されます。アプリケーション開発者とアセンブリプロバイダーは、通常、アクティブ化コンテキストを管理するためにスタックを呼び出す必要はありません。

間接またはディスパッチレイヤーを実装するプロセスとアプリケーション。

たとえば、イベントループでアクティブ化コンテキストを管理しているユーザーなどです。ウィンドウにマウスを移動するなど、ウィンドウにアクセスするたびに ActivateActCtx が呼び出され、次のコードフラグメントに示すように、リソースの現在のアクティブ化コンテキストがアクティブ化されます。

HANDLE hActCtx;  
CreateWindow();  
...  
GetCurrentActCtx(&ActCtx);  
...  
ReleaseActCtx(&ActCtx);

In the following code fragment, the API function activates the appropriate activation contexts before calling [**CallWindowProc**](/windows/win32/api/winuser/nf-winuser-callwindowproca). When **CallWindowProc** is called, it uses this context to pass a message to Windows. When all resource operations have completed, the function will deactivate the context.

ULONG\_PTR ulpCookie;  
HANDLE hActCtx;  
if(ActivateActCtx(hActCtx, &ulpCookie))  
{  
    ...  
    CallWindowProc(...);  
    ...  
    DeactivateActCtx(0, ulpCookie);  
}

委任者ディスパッチレイヤー。

このシナリオは、ドライバーマネージャーなど、共通の API レイヤーを使用して複数のエンティティを管理するマネージャーに適用されます。まだ実装されていませんが、この例は ODBC ドライバーです。

このシナリオでは、中間レイヤーでアセンブリバインドを処理できるようになります。バージョン固有のバインディングドライバーを取得するには、パブリッシャーがマニフェストを提供し、そのマニフェスト内の特定のコンポーネントに対する依存関係を指定する必要があります。基本アプリケーションは、コンポーネントに動的にバインドされません。実行時に、ドライバーマネージャーが呼び出しを管理します。接続文字列に基づいて ODBC ドライバーが呼び出されると、適切なドライバーが読み込まれます。次に、アセンブリマニフェストファイル内の情報を使用してアクティブ化コンテキストを作成します。

マニフェストがない場合、ドライバーの既定のアクションは、アプリケーションで指定されたコンテキスト (この例ではバージョン 2 の MSVCRT) を使用することです。マニフェストが存在するため、個別のアクティブ化コンテキストが確立されます。 ODBC ドライバーを実行すると、MSVCRT アセンブリのバージョン 1 にバインドされます。

ドライバーマネージャーがディスパッチレイヤーを呼び出すたびに (たとえば、次のデータセットを取得するために)、アクティブ化コンテキストに基づいて適切なアセンブリが使用されます。次のコードフラグメントは、これを示しています。

HANDLE hActCtx;  
ULONG\_PTR ulpCookie;  
ACTCTX ActCtxToCreate = {...};  
hActCtx = CreateActCtx(&ActCtxToCreate);  
...;  
if (ActivateActCtx(hActCtx, &ulpCookie))  
{  
    ...  
    ConnectDb(...);  
    DeactivateActCtx(0, ulpCookie);  
}  
... 
ReleaseActCtx(hActCtx);