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

Статья
11/20/2024

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

Синтаксис

HANDLE CreateActCtxW(
  [in, out] PCACTCTXW pActCtx
);

Параметры

[in, out] pActCtx

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

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

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

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

Замечания

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

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	winbase.h (включая Windows.h)
библиотеки	Kernel32.lib
DLL	Kernel32.dll

См. также

ACTCTX

Поделиться через