Método IDebugEventCallbacks::ChangeSymbolState (dbgeng.h)

  • Artigo

O método de retorno de chamada ChangeSymbolState é chamado pelo mecanismo quando o estado do símbolo é alterado.

Sintaxe

HRESULT ChangeSymbolState(
  [in] ULONG   Flags,
  [in] ULONG64 Argument
);

Parâmetros

[in] Flags

Especifica um conjunto de bits que indica a natureza da alteração no estado do símbolo. Os sinalizadores de bit a seguir podem ser definidos.

Valor Descrição
DEBUG_CSS_LOADS O mecanismo carregou alguns símbolos de módulo.
DEBUG_CSS_UNLOADS O mecanismo descarregou alguns símbolos de módulo.
DEBUG_CSS_SCOPE O escopo do símbolo atual foi alterado.
DEBUG_CSS_PATHS Os caminhos de pesquisa de imagem executável, de origem ou de símbolo foram alterados.
DEBUG_CSS_SYMBOL_OPTIONS As opções de símbolo foram alteradas.
DEBUG_CSS_TYPE_OPTIONS As opções de tipo foram alteradas.

[in] Argument

Fornece informações adicionais sobre a alteração no estado do símbolo. Se mais de um sinalizador de bit for definido no parâmetro Flags , o parâmetro Argument não será usado. Caso contrário, o valor de Argument depende do valor de Flags:

DEBUG_CSS_LOADS

O valor de Argument é o local base (no espaço de endereço de memória do destino) da imagem do módulo para a qual o mecanismo carregou símbolos.

DEBUG_CSS_UNLOADS

O valor de Argument é o local base (no espaço de endereço de memória do destino) da imagem do módulo para a qual o mecanismo descarregou símbolos. Se o mecanismo descarregou símbolos para mais de uma imagem, o valor de Argument será zero.

DEBUG_CSS_SCOPE

O valor de Argument é zero.

DEBUG_CSS_PATHS

O valor de Argument é zero.

DEBUG_CSS_SYMBOL_OPTIONS

O valor de Argument é as opções de símbolo.

DEBUG_CSS_TYPE_OPTIONS

O valor de Argument é zero.

Retornar valor

O valor retornado é ignorado pelo mecanismo, a menos que indique um erro de chamada de procedimento remoto; nesse caso, o cliente, com o qual esse objeto IDebugEventCallbacks está registrado, está desabilitado.

Comentários

Esse método só será chamado pelo mecanismo se o sinalizador DEBUG_EVENT_CHANGE_SYMBOL_STATE for definido na máscara retornada por IDebugEventCallbacks::GetInterestMask.

Para obter mais informações sobre como lidar com eventos, consulte Eventos de monitoramento.

Requisitos

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