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

Confira também

ACTCTX

DeactivateActCtx