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

Confira também

ACTCTX