共用方式為


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 所在的框架。

[in] ulCookie

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

傳回值

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

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

備註

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

規格需求

   
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 winbase.h (包含 Windows.h)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

ActivateActCtx