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
Valor de retorno
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 Last-Error Code. Para obter uma lista completa de códigos de erro, consulte Códigos de Erro do Sistema.
Observações
Defina os bits indefinidos em dwFlags de ACTCTX como 0. Se os bits indefinidos não forem definidos 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.
Nota
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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows XP [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows Server 2003 [somente aplicativos da área de trabalho] |
| da Plataforma de Destino |
Windows |
| cabeçalho | winbase.h (inclua Windows.h) |
| biblioteca | Kernel32.lib |
| de DLL |
Kernel32.dll |