Fonction SymGetOptions (dbghelp.h)

Récupère le masque d’option actuel.

Syntaxe

DWORD IMAGEAPI SymGetOptions();

Valeur de retour

La fonction retourne les options actuelles qui ont été définies. Zéro est une valeur valide et indique que toutes les options sont désactivées.

Remarques

Ces options peuvent être modifiées plusieurs fois pendant que la bibliothèque est utilisée par une application. Toute modification d’option affecte tous les appels futurs au gestionnaire de symboles.

La valeur de retour est la combinaison des valeurs suivantes qui ont été définies à l’aide de la fonction SymSetOptions .

  • SYMOPT_ALLOW_ABSOLUTE_SYMBOLS
  • SYMOPT_ALLOW_ZERO_ADDRESS
  • SYMOPT_AUTO_PUBLICS
  • SYMOPT_CASE_INSENSITIVE
  • SYMOPT_DEBUG
  • SYMOPT_DEFERRED_LOADS
  • SYMOPT_EXACT_SYMBOLS
  • SYMOPT_FAIL_CRITICAL_ERRORS
  • SYMOPT_FAVOR_COMPRESSED
  • SYMOPT_FLAT_DIRECTORY
  • SYMOPT_IGNORE_CVREC
  • SYMOPT_IGNORE_IMAGEDIR
  • SYMOPT_IGNORE_NT_SYMPATH
  • SYMOPT_INCLUDE_32BIT_MODULES
  • SYMOPT_LOAD_ANYTHING
  • SYMOPT_LOAD_LINES
  • SYMOPT_NO_CPP
  • SYMOPT_NO_IMAGE_SEARCH
  • SYMOPT_NO_PROMPTS
  • SYMOPT_NO_PUBLICS
  • SYMOPT_NO_UNQUALIFIED_LOADS
  • SYMOPT_OVERWRITE
  • SYMOPT_PUBLICS_ONLY
  • SYMOPT_SECURE
  • SYMOPT_UNDNAME
Toutes les fonctions DbgHelp, telles que celle-ci, sont à thread unique. Par conséquent, les appels de plusieurs threads à cette fonction entraîneront probablement un comportement inattendu ou une altération de la mémoire. Pour éviter cela, vous devez synchroniser tous les appels simultanés de plusieurs threads vers cette fonction.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête dbghelp.h
Bibliothèque Dbghelp.lib
DLL Dbghelp.dll
Composant redistribuable DbgHelp.dll 5.1 ou version ultérieure

Voir aussi

Fonctions DbgHelp