SymGetOptions-Funktion (dbghelp.h)

Artikel
02/26/2024

Ruft das aktuelle Optionsformat ab.

Syntax

DWORD IMAGEAPI SymGetOptions();

Rückgabewert

Die Funktion gibt die aktuellen Optionen zurück, die festgelegt wurden. Null ist ein gültiger Wert und gibt an, dass alle Optionen deaktiviert sind.

Hinweise

Diese Optionen können mehrmals geändert werden, während die Bibliothek von einer Anwendung verwendet wird. Jede Optionsänderung wirkt sich auf alle zukünftigen Aufrufe des Symbolhandlers aus.

Der Rückgabewert ist die Kombination der folgenden Werte, die mit der SymSetOptions-Funktion festgelegt wurden.

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

Alle DbgHelp-Funktionen, z. B. diese, sind singlethreaded. Daher führen an diese Funktion gerichtete Aufrufe mehrerer Threads wahrscheinlich zu unerwartetem Verhalten oder einer Beschädigung des Speichers. Um dies zu vermeiden, müssen Sie alle an diese Funktion gerichteten gleichzeitigen Aufrufe mehrerer Threads synchronisieren.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	dbghelp.h
Bibliothek	Dbghelp.lib
DLL	Dbghelp.dll
Verteilbare Komponente	DbgHelp.dll 5.1 oder höher

Weitere Informationen

DbgHelp-Funktionen

Freigeben über