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

Функция CreateActCtx создает контекст активации.

Синтаксис

HANDLE CreateActCtxA(
  [in, out] PCACTCTXA pActCtx
);

Параметры

[in, out] pActCtx

Указатель на структуру ACTCTX , содержащую сведения о создаваемом контексте активации.

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

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

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

Комментарии

Задайте для всех неопределенных битов в dwFlagsACTCTX значение 0. Если какие-либо неопределенные биты не имеют значения 0, вызов CreateActCtx , создающий контекст активации, завершается ошибкой и возвращает недопустимый код ошибки параметра. Дескриптор, возвращаемый из CreateActCtx , передается в вызове ActivateActCtx для активации контекста для текущего потока.

Примечание

Заголовок winbase.h определяет CreateActCtx в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

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

См. также

ACTCTX