ActivateActCtx 函数 (winbase.h)

ActivateActCtx 函数激活指定的激活上下文。它通过将指定的激活上下文推送到激活堆栈顶部来执行此操作。因此，指定的激活上下文与当前线程和任何适当的并行 API 函数相关联。

语法

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

[in] hActCtx

ACTCTX 结构的句柄，该结构包含有关要激活的激活上下文的信息。

[out] lpCookie

指向 ULONG_PTR 的指针，该ULONG_PTR充当 Cookie，唯一标识特定的已激活上下文。

如果该函数成功，则返回 TRUE。否则，它将返回 FALSE。

此函数设置可通过调用 GetLastError 检索的错误。有关示例，请参阅检索 Last-Error 代码。有关错误代码的完整列表，请参阅系统错误代码。

lpCookie 参数稍后传递给 DeactivateActCtx，这将验证对 ActivateActCtx 和 DeactivateActCtx 的调用配对，并确保停用相应的激活上下文。这样做是因为激活上下文的停用必须以相反的激活顺序进行。

激活上下文可以理解为将激活上下文推送到激活上下文堆栈。通过此函数激活的激活上下文会将任何绑定重定向到所调用的任何并行 API 的 DLL、窗口类、COM 服务器、类型库和互斥体。

激活上下文堆栈的顶部项是当前线程的活动默认激活上下文。如果将 null 激活上下文句柄推送到堆栈上，从而激活它，则原始清单中的默认设置将覆盖堆栈上较低的所有激活上下文。