Partilhar via


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

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. Opções é um conjunto de bits; ele substituirá as opções de símbolo existentes. Para obter uma descrição dos sinalizadores de bits, consulte Definindo opções de símbolo.

Valor de retorno

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

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

Observações

Esse método definirá as opções de símbolo global do mecanismo para as especificadas no opções de. Ao contrário de AddSymbolOptions, todas as opções de símbolo que não estiverem no conjunto de bits Opções serão removidas.

Depois que as opções de símbolo tiverem sido 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 Symbols.

Requisitos

Requisito Valor
da Plataforma de Destino Área de trabalho
cabeçalho dbgeng.h (inclua Dbgeng.h, Dbghelp.h)

Consulte também

AddSymbolOptions

GetSymbolOptions

IDebugSymbols

IDebugSymbols2

IDebugSymbols3

RemoveSymbolOptions