Função CreateActCtxA (winbase.h)
A função CreateActCtx cria um contexto de ativação.
Sintaxe
HANDLE CreateActCtxA(
[in, out] PCACTCTXA pActCtx
);
Parâmetros
[in, out] pActCtx
Ponteiro para uma estrutura ACTCTX que contém informações sobre o contexto de ativação a ser criado.
Retornar valor
Se a função for bem-sucedida, ela retornará um identificador para o contexto de ativação retornado. Caso contrário, ele retornará INVALID_HANDLE_VALUE.
Essa função define erros que podem ser recuperados chamando GetLastError. Para obter um exemplo, consulte Recuperando o código de Last-Error. Para obter uma lista completa de códigos de erro, consulte Códigos de erro do sistema.
Comentários
Defina todos os bits indefinidos em dwFlags de ACTCTX como 0. Se algum bit indefinido não estiver definido como 0, a chamada para CreateActCtx que cria o contexto de ativação falhará e retornará um código de erro de parâmetro inválido. O identificador retornado de CreateActCtx é passado em uma chamada para ActivateActCtx para ativar o contexto do thread atual.
Observação
O cabeçalho winbase.h define CreateActCtx como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | winbase.h (incluir Windows.h) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |