Função ActivateActCtx (winbase.h)
A função ActivateActCtx ativa o contexto de ativação especificado. Ele faz isso enviando por push o contexto de ativação especificado para a parte superior da pilha de ativação. Assim, o contexto de ativação especificado está associado ao thread atual e a quaisquer funções de API lado a lado apropriadas.
Sintaxe
BOOL ActivateActCtx(
[in] HANDLE hActCtx,
[out] ULONG_PTR *lpCookie
);
Parâmetros
[in] hActCtx
Manipule para uma estrutura ACTCTX que contém informações sobre o contexto de ativação que deve se tornar ativo.
[out] lpCookie
Ponteiro para um ULONG_PTR que funciona como um cookie, identificando exclusivamente um contexto de ativação específico e ativado.
Retornar valor
Se a função for bem-sucedida, ela retornará TRUE. Caso contrário, retornará FALSE.
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
O parâmetro lpCookie é passado posteriormente para DeactivateActCtx, que verifica o emparelhamento de chamadas para ActivateActCtx e DeactivateActCtx e garante que o contexto de ativação apropriado esteja sendo desativado. Isso é feito porque a desativação de contextos de ativação deve ocorrer na ordem inversa de ativação.
A ativação de contextos de ativação pode ser entendida como efetuando push de um contexto de ativação para uma pilha de contextos de ativação. O contexto de ativação que você ativa por meio dessa função redireciona qualquer associação para DLLs, classes de janela, servidores COM, bibliotecas de tipos e mutexes para qualquer APIs lado a lado que você chamar.
O item superior de uma pilha de contexto de ativação é o contexto ativo de ativação padrão do thread atual. Se um identificador de contexto de ativação nula for enviado por push para a pilha, ativando-o, as configurações padrão no manifesto original substituirão todos os contextos de ativação que estão mais baixos na pilha.
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 |