Функция ДеактивацияActCtx (winbase.h)

Статья
08/27/2023

Функция DeactivateActCtx деактивирует контекст активации, соответствующий указанному файлу cookie.

Синтаксис

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

Параметры

[in] dwFlags

Флаги, указывающие, как будет происходить деактивация.

Значение	Значение
0	Если это значение задано и файл cookie, указанный в параметре ulCookie , находится в верхней рамке стека активации, контекст активации выскочиется из стека и тем самым деактивируется. Если это значение задано и файл cookie, указанный в параметре ulCookie , не находится в верхней рамке стека активации, эта функция выполняет поиск файла cookie в стеке. При обнаружении файла cookie создается STATUS_SXS_EARLY_DEACTIVATION исключение. Если файл cookie не найден, создается STATUS_SXS_INVALID_DEACTIVATION исключение. Это значение следует указывать в большинстве случаев.
DEACTIVATE_ACTCTX_FLAG_FORCE_EARLY_DEACTIVATION	Если это значение задано и файл cookie, указанный в параметре ulCookie , находится в верхней рамке стека активации, функция возвращает код ошибки ERROR_INVALID_PARAMETER. Вызовите Метод GetLastError , чтобы получить этот код. Если это значение задано, а файл cookie отсутствует в стеке активации, возникнет исключение STATUS_SXS_INVALID_DEACTIVATION. Если это значение задано и файл cookie находится в нижнем кадре стека активации, из стека выскочат все кадры вплоть до кадра, в который находится файл cookie.

Значение

0

Если это значение задано и файл cookie, указанный в параметре ulCookie , находится в верхней рамке стека активации, контекст активации выскочиется из стека и тем самым деактивируется.

Если это значение задано и файл cookie, указанный в параметре ulCookie , не находится в верхней рамке стека активации, эта функция выполняет поиск файла cookie в стеке.

При обнаружении файла cookie создается STATUS_SXS_EARLY_DEACTIVATION исключение.

Если файл cookie не найден, создается STATUS_SXS_INVALID_DEACTIVATION исключение.

Это значение следует указывать в большинстве случаев.

DEACTIVATE_ACTCTX_FLAG_FORCE_EARLY_DEACTIVATION

Если это значение задано и файл cookie, указанный в параметре ulCookie , находится в верхней рамке стека активации, функция возвращает код ошибки ERROR_INVALID_PARAMETER. Вызовите Метод GetLastError , чтобы получить этот код.

Если это значение задано, а файл cookie отсутствует в стеке активации, возникнет исключение STATUS_SXS_INVALID_DEACTIVATION.

Если это значение задано и файл cookie находится в нижнем кадре стека активации, из стека выскочат все кадры вплоть до кадра, в который находится файл cookie.

[in] ulCookie

ULONG_PTR, переданный в вызов ActivateActCtx. Это значение используется в качестве файла cookie для идентификации конкретного активированного контекста активации.

Возвращаемое значение

Если функция выполняется успешно, возвращается значение TRUE. В противном случае возвращается значение FALSE.

Эта функция задает ошибки, которые можно получить, вызвав Метод GetLastError. Пример см. в разделе Извлечение кода Last-Error. Полный список кодов ошибок см. в разделе Системные коды ошибок.

Требования


Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	winbase.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll

См. также

ActivateActCtx