Compartilhar via

Função DeactivateActCtx (winbase.h)

  • Artigo

A função DeactivateActCtx desativa o contexto de ativação correspondente ao cookie especificado.

Sintaxe

BOOL DeactivateActCtx(
  [in] DWORD     dwFlags,
  [in] ULONG_PTR ulCookie
);

Parâmetros

[in] dwFlags

Sinalizadores que indicam como a desativação deve ocorrer.

Valor Significado
0
 Se esse valor for definido e o cookie especificado no parâmetro ulCookie estiver no quadro superior da pilha de ativação, o contexto de ativação será exibido da pilha e, assim, desativado.

Se esse valor for definido e o cookie especificado no parâmetro ulCookie não estiver no quadro superior da pilha de ativação, essa função pesquisará a pilha do cookie.

Se o cookie for encontrado, uma exceção STATUS_SXS_EARLY_DEACTIVATION será gerada.

Se o cookie não for encontrado, uma exceção STATUS_SXS_INVALID_DEACTIVATION será gerada.

Esse valor deve ser especificado na maioria dos casos.
DEACTIVATE_ACTCTX_FLAG_FORCE_EARLY_DEACTIVATION
 Se esse valor for definido e o cookie especificado no parâmetro ulCookie estiver no quadro superior da pilha de ativação, a função retornará um código de erro ERROR_INVALID_PARAMETER. Chame GetLastError para obter esse código.

Se esse valor for definido e o cookie não estiver na pilha de ativação, uma exceção STATUS_SXS_INVALID_DEACTIVATION será gerada.

Se esse valor for definido e o cookie estiver em um quadro inferior da pilha de ativação, todos os quadros até e incluindo o quadro em que o cookie está serão exibidos da pilha.

[in] ulCookie

O ULONG_PTR que foi passado para a chamada para ActivateActCtx. Esse valor é usado como um cookie para identificar um contexto de ativação ativado específico.

Valor retornado

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

A desativação de contextos de ativação deve ocorrer na ordem inversa da ativação. Ele pode ser entendido como estourando um contexto de ativação de uma pilha.

Requisitos

   
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 (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

ActivateActCtx