Método IDebugSymbols3::SetSymbolOptions (dbgeng.h)

Artigo
02/23/2024

O método SetSymbolOptions altera as opções de símbolo global do mecanismo.

Sintaxe

HRESULT SetSymbolOptions(
  [in] ULONG Options
);

Parâmetros

[in] Options

Especifica as novas opções de símbolo. As opções são um conjunto de bits; ele substituirá as opções de símbolo existentes. Para obter uma descrição dos sinalizadores de bits, consulte Configurando opções de símbolo.

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 definirá as opções de símbolo global do mecanismo para as especificadas em Opções. Ao contrário de AddSymbolOptions, todas as opções de símbolo que não estiverem nas Opções do conjunto de bits serão removidas.

Depois que as opções de símbolo forem alteradas, para cada cliente, o mecanismo enviará uma notificação para IDebugEventCallbacks desse cliente passando o sinalizador DEBUG_CES_SYMBOL_OPTIONS para o método IDebugEventCallbacks::ChangeSymbolState .

Para obter mais informações sobre símbolos, consulte Símbolos.