Método IDebugClient2::EndSession (dbgeng.h)

  • Artigo

O método EndSession encerra a sessão atual do depurador.

Sintaxe

HRESULT EndSession(
  [in] ULONG Flags
);

Parâmetros

[in] Flags

Especifica como encerrar a sessão. Os sinalizadores podem ser um dos seguintes valores:

Sinalizador Descrição
DEBUG_END_PASSIVE Execute a limpeza da sessão.
DEBUG_END_ACTIVE_TERMINATE Tente encerrar todos os destinos do modo de usuário antes de executar a limpeza da sessão.
DEBUG_END_ACTIVE_DETACH Tente se desconectar de todos os destinos antes de executar a limpeza da sessão.
DEBUG_END_REENTRANT Execute apenas a limpeza que não requer a aquisição de bloqueios. Consulte a seção Comentários para obter detalhes.
DEBUG_END_DISCONNECT Não termine a sessão. Desconecte o cliente da sessão e desabilite o cliente.

Esse sinalizador destina-se a quando os clientes remotos se desconectam. Ele gera uma mensagem de servidor sobre a desconexão.

Retornar valor

Esse método também pode retornar valores de erro. Consulte Valores retornados para obter mais detalhes.

Código de retorno Descrição
S_OK
 O método foi bem-sucedido.

Comentários

Esse método pode ser chamado a qualquer momento com Sinalizadores definidos como DEBUG_END_REENTRANT. Se, por exemplo, o aplicativo precisar sair, mas outro thread estiver usando o mecanismo, esse método poderá ser usado para executar o máximo de limpeza possível.

Usar DEBUG_END_REENTRANT pode deixar o mecanismo em um estado indeterminado. Se esse sinalizador for usado, nenhuma chamada subsequente deverá ser feita para o mecanismo.

Para obter mais informações sobre sessões de depurador, consulte Depurando o modelo de sessão e execução.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho dbgeng.h (inclua Dbgeng.h)