Функция ActivateActCtx (winbase.h)

Статья
08/27/2023

Функция ActivateActCtx активирует указанный контекст активации. Это делается путем отправки указанного контекста активации в верхнюю часть стека активации. Таким образом, указанный контекст активации связан с текущим потоком и любыми соответствующими параллельными функциями API.

Синтаксис

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

Параметры

[in] hActCtx

Обработка структуры ACTCTX , содержащей сведения о контексте активации, который должен быть активирован.

[out] lpCookie

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

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

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

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

Затем параметр lpCookie передается в DeactivateActCtx, который проверяет связывание вызовов ActivateActCtx и DeactivateActCtx и гарантирует деактивацию соответствующего контекста активации. Это делается потому, что деактивация контекстов активации должна происходить в обратном порядке активации.

Активация контекстов активации может быть понята как отправка контекста активации в стек контекстов активации. Контекст активации, активируемый с помощью этой функции, перенаправляет любую привязку в библиотеки DLL, классы окон, COM-серверы, библиотеки типов и мьютексы для любых параллельных API, которые вы вызываете.

Верхним элементом стека контекста активации является активный контекст активации по умолчанию текущего потока. Если дескриптор контекста пустой активации передается в стек, тем самым активируя его, параметры по умолчанию в исходном манифесте переопределяют все контексты активации, которые находятся ниже в стеке.

Требования

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

См. также

ACTCTX

ДеактивацияActCtx