DeactivateActCtx 函式 (winbase.h)

DeactivateActCtx函式會停用對應至指定 Cookie 的啟用內容。

語法

BOOL DeactivateActCtx(
  [in] DWORD     dwFlags,
  [in] ULONG_PTR ulCookie
);

[in] dwFlags

指出停用發生方式的旗標。

值	意義
0	如果已設定這個值，而且 ulCookie 參數中指定的 Cookie 位於啟用堆疊的頂端框架中，則會從堆疊中彈出啟用內容，因而停用。如果已設定此值，而且 ulCookie 參數中指定的 Cookie 不在啟用堆疊的頂端框架中，則此函式會向下搜尋堆疊中的 Cookie。如果找到 Cookie，則會擲回STATUS_SXS_EARLY_DEACTI加值稅ION例外狀況。如果找不到 Cookie，則會擲回STATUS_SXS_INVALID_DEACTI加值稅ION例外狀況。在大部分情況下，應該指定此值。
DEACTI加值稅E_ACTCTX_FLAG_FORCE_EARLY_DEACTI加值稅ION	如果已設定這個值，且 ulCookie 參數中指定的 Cookie 位於啟用堆疊的頂端框架中，則函式會傳回ERROR_INVALID_PARAMETER錯誤碼。呼叫 GetLastError 以取得此程式碼。如果已設定此值，而且 Cookie 不在啟用堆疊上，則會擲回STATUS_SXS_INVALID_DEACTI加值稅ION例外狀況。如果已設定此值，且 Cookie 位於啟用堆疊的下層框架中，則會從堆疊中擷取 Cookie 的所有畫面，並納入該 Cookie 所在的框架。

值

意義

如果已設定這個值，而且 ulCookie 參數中指定的 Cookie 位於啟用堆疊的頂端框架中，則會從堆疊中彈出啟用內容，因而停用。

如果已設定此值，而且 ulCookie 參數中指定的 Cookie 不在啟用堆疊的頂端框架中，則此函式會向下搜尋堆疊中的 Cookie。

如果找到 Cookie，則會擲回STATUS_SXS_EARLY_DEACTI加值稅ION例外狀況。

如果找不到 Cookie，則會擲回STATUS_SXS_INVALID_DEACTI加值稅ION例外狀況。

在大部分情況下，應該指定此值。

如果已設定這個值，且 ulCookie 參數中指定的 Cookie 位於啟用堆疊的頂端框架中，則函式會傳回ERROR_INVALID_PARAMETER錯誤碼。呼叫 GetLastError 以取得此程式碼。

如果已設定此值，而且 Cookie 不在啟用堆疊上，則會擲回STATUS_SXS_INVALID_DEACTI加值稅ION例外狀況。

如果已設定此值，且 Cookie 位於啟用堆疊的下層框架中，則會從堆疊中擷取 Cookie 的所有畫面，並納入該 Cookie 所在的框架。

[in] ulCookie

傳遞至 ActivateActCtx呼叫的ULONG_PTR。這個值會當做 Cookie 用來識別特定啟用的啟用內容。

如果函式成功，則會傳回 TRUE。否則會傳回 FALSE。

此函式會設定可藉由呼叫 GetLastError擷取的錯誤。如需範例，請參閱擷取 Last-Error 程式碼。如需錯誤碼的完整清單，請參閱系統錯誤碼。

啟用內容的停用必須以啟用的反向順序發生。它可視為從堆疊推出啟用內容。