ActivateActCtx 関数 (winbase.h)

ActivateActCtx 関数は、指定したアクティブ化コンテキストをアクティブ化します。 これは、指定したアクティブ化コンテキストをアクティブ化スタックの先頭にプッシュすることによって行われます。 したがって、指定されたアクティブ化コンテキストは、現在のスレッドと適切なサイドバイサイド API 関数に関連付けられます。

構文

BOOL ActivateActCtx(
  [in]  HANDLE    hActCtx,
  [out] ULONG_PTR *lpCookie
);

パラメーター

[in] hActCtx

アクティブにするアクティブ化コンテキストに関する情報を含む ACTCTX 構造体を処理します。

[out] lpCookie

Cookie として機能する ULONG_PTR へのポインター。アクティブ化された特定のアクティブ化コンテキストを一意に識別します。

戻り値

関数が成功すると、 TRUE が返されます。 それ以外の場合は、 FALSE を返します。

この関数は 、GetLastError を呼び出すことによって取得できるエラーを設定します。 例については、「 Last-Error コードの取得」を参照してください。 エラー コードの完全な一覧については、「 システム エラー コード」を参照してください。

注釈

lpCookie パラメーターは後で DeactivateActCtx に渡され、ActivateActCtx と DeactivateActCtx の呼び出しのペアリングが検証され、適切なアクティブ化コンテキストが非アクティブ化されていることを確認します。 これは、アクティブ化コンテキストの非アクティブ化がアクティブ化の逆の順序で行われる必要があるためです。

アクティブ化コンテキストのアクティブ化は、アクティブ化コンテキストをアクティブ化コンテキストのスタックにプッシュすると理解できます。 この関数を介してアクティブ化するアクティブ化コンテキストは、呼び出す任意のサイド バイ サイド API の DLL、ウィンドウ クラス、COM サーバー、タイプ ライブラリ、ミューテックスにバインドをリダイレクトします。

アクティブ化コンテキスト スタックの最上位項目は、現在のスレッドのアクティブな既定のアクティブ化コンテキストです。 null アクティブ化コンテキスト ハンドルがスタックにプッシュされ、それによってアクティブ化される場合、元のマニフェストの既定の設定は、スタックの下位にあるすべてのアクティブ化コンテキストをオーバーライドします。

要件

関連項目

ACTCTX

DeactivateActCtx