Função SymSetOptions (dbghelp.h)
Define a máscara de opções.
Sintaxe
DWORD IMAGEAPI SymSetOptions(
[in] DWORD SymOptions
);
Parâmetros
[in] SymOptions
As opções de símbolo. Zero é um valor válido e indica que todas as opções estão desativadas. Os valores de opções são combinados usando o operador OR para formar um valor de opções válido. Os seguintes valores são válidos:
| Valor | Significado |
|---|---|
|
Habilita o uso de símbolos armazenados com endereços absolutos. A maioria dos símbolos é armazenada como RVAs da base do módulo. DbgHelp os converte em endereços absolutos. Há símbolos armazenados como um endereço absoluto. Elas têm finalidades muito especializadas e normalmente não são usadas.
DbgHelp 5.1 e anterior: Não há suporte para esse valor. |
|
Habilita o uso de símbolos que não têm um endereço. Por padrão, dbgHelp filtra símbolos que não têm um endereço. |
|
Não pesquise os símbolos públicos ao pesquisar símbolos por endereço ou ao enumerar símbolos, a menos que eles não tenham sido encontrados nos símbolos globais ou dentro do escopo atual. Essa opção não tem efeito com SYMOPT_PUBLICS_ONLY.
DbgHelp 5.1 e anterior: Não há suporte para esse valor. |
|
Todas as pesquisas de símbolos não diferenciam maiúsculas de minúsculas. |
|
Passe a saída de depuração por meio de OutputDebugString ou da função de retorno de chamada SymRegisterCallbackProc64 . |
|
Os símbolos não são carregados até que uma referência seja feita exigindo que os símbolos sejam carregados. Essa é a maneira mais rápida e eficiente de usar o manipulador de símbolos. |
|
Desabilita a detecção automática de repositórios de servidor de símbolos no caminho do símbolo, mesmo sem a designação "SRV*", mantendo a compatibilidade com o comportamento anterior.
DbgHelp 6.6 e anteriores: Não há suporte para esse valor. |
|
Não carregue um arquivo .pdb sem correspondência. Não carregue símbolos de exportação se tudo falhar. |
|
Não exiba caixas de diálogo do sistema quando houver uma falha de mídia, como nenhuma mídia em uma unidade. Em vez disso, a falha ocorre silenciosamente. |
|
Se houver um arquivo descompactado e compactado disponível, favorecimento ao arquivo compactado. Essa opção é boa para conexões lentas. |
|
Os símbolos são armazenados no diretório raiz do repositório downstream padrão.
DbgHelp 6.1 e anterior: Não há suporte para esse valor. |
|
Ignore as informações de caminho no registro CodeView do cabeçalho da imagem ao carregar um arquivo .pdb. |
|
Ignore o diretório de imagem.
DbgHelp 6.1 e anterior: Não há suporte para esse valor. |
|
Não use o caminho especificado por _NT_SYMBOL_PATH se o usuário chamar SymSetSearchPath sem um caminho válido.
DbgHelp 5.1: Não há suporte para esse valor. |
|
Ao depurar no Windows de 64 bits, inclua todos os módulos de 32 bits. |
|
Desabilite as verificações para garantir que um arquivo (.exe, .dbg.ou .pdb) seja o arquivo correto. Em vez disso, carregue o primeiro arquivo localizado. |
|
Carrega informações de número de linha. |
|
Todos os símbolos decorados do C++ que contêm o separador de símbolos "::" são substituídos por "__". Essa opção existe para depuradores que não podem lidar com a análise de nomes de símbolos C++ reais. |
|
Não pesquise na imagem o caminho do símbolo ao carregar os símbolos de um módulo se o cabeçalho do módulo não puder ser lido.
DbgHelp 5.1: Não há suporte para esse valor. |
|
Impede a solicitação de validação do servidor de símbolos. |
|
Não pesquise símbolos na tabela de públicos. Essa opção deve ter pouco efeito porque há cópias dos símbolos públicos na tabela global.
DbgHelp 5.1: Não há suporte para esse valor. |
|
Impede que símbolos sejam carregados quando o chamador examina símbolos em vários módulos. Examine apenas o módulo cujos símbolos já foram carregados. |
|
Substitua o repositório de nível inferior do repositório de símbolos.
DbgHelp 6.1 e anterior: Não há suporte para esse valor. |
|
Não use símbolos privados. A versão do DbgHelp que acompanhava a versão anterior do Windows tinha suporte apenas para símbolos públicos; essa opção fornece compatibilidade com essa limitação.
DbgHelp 5.1: Não há suporte para esse valor. |
|
DbgHelp não carregará nenhum servidor de símbolos diferente de SymSrv. O SymSrv não usará o repositório downstream especificado em _NT_SYMBOL_PATH. Depois que esse sinalizador tiver sido definido, ele não poderá ser limpo.
DbgHelp 6.0 e 6.1: Esse sinalizador pode ser limpo. DbgHelp 5.1: Não há suporte para esse valor. |
|
Todos os símbolos são apresentados em formato não decorado.
Essa opção não tem efeito sobre símbolos globais ou locais porque eles são armazenados sem cor. Essa opção se aplica somente a símbolos públicos. |
Valor retornado
A função retorna a máscara de opções atual.
Comentários
O valor de opções pode ser alterado várias vezes enquanto a biblioteca está em uso por um aplicativo. A alteração de opção afeta todas as chamadas futuras para o manipulador de símbolos.
Para obter a máscara de opções atual, chame a função SymGetOptions .
Todas as funções DbgHelp, como esta, são threaded único. Portanto, chamadas de mais de um thread para essa função provavelmente resultarão em comportamento inesperado ou corrupção de memória. Para evitar isso, você deve sincronizar todas as chamadas simultâneas de mais de um thread para essa função.
Exemplos
Para obter um exemplo, consulte Inicializando o manipulador de símbolos.
Requisitos
| Plataforma de Destino | Windows |
| Cabeçalho | dbghelp.h |
| Biblioteca | Dbghelp.lib |
| DLL | Dbghelp.dll |
| Redistribuível | DbgHelp.dll 5.1 ou posterior |