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 的呼叫配對，並確保已停用適當的啟用內容。這是因為啟用內容的停用必須以反向啟用順序發生。

啟用內容可視為將啟用內容推送至啟用內容的堆疊。您透過此函式啟動的內容會將任何系結重新導向至 DLL、視窗類別、COM 伺服器、類型連結庫，以及您呼叫的任何並存 API Mutex。

啟用內容堆疊的最上層專案是目前線程的作用中、預設啟用內容。如果 Null 啟用內容句柄推送至堆疊，藉此啟用它，原始指令清單中的預設設定會覆寫堆疊上較低的所有啟用內容。