Функция CreateActCtxW (winbase.h)
Функция 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 [только классические приложения] |
Целевая платформа | Windows |
Header | winbase.h (включая Windows.h) |
Библиотека | Kernel32.lib |
DLL | Kernel32.dll |