SymSetContext-Funktion (dbghelp.h)
Legt kontextbezogene Informationen fest, die von der SymEnumSymbols-Funktion verwendet werden. Diese Funktion funktioniert nur mit PDB-Symbolen.
Syntax
BOOL IMAGEAPI SymSetContext(
[in] HANDLE hProcess,
[in] PIMAGEHLP_STACK_FRAME StackFrame,
[in, optional] PIMAGEHLP_CONTEXT Context
);
Parameter
[in] hProcess
Ein Handle für einen Prozess. Dieses Handle muss zuvor an die SymInitialize-Funktion übergeben worden sein.
[in] StackFrame
Ein Zeiger auf eine IMAGEHLP_STACK_FRAME-Struktur , die Frameinformationen enthält.
[in, optional] Context
Konvertiert die Zeichenfolgendarstellung einer Zahl in einem angegebenen Stil und einem kulturspezifischen Format in die entsprechende 32-Bit-Ganzzahl mit Vorzeichen.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE.
Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen abzurufen.
Hinweise
Wenn Sie SymSetContext aufrufen, um den Kontext auf den aktuellen Wert festzulegen, schlägt die Funktion fehl, aber GetLastError gibt ERROR_SUCCESS zurück.
Alle DbgHelp-Funktionen, z. B. diese, sind single threaded. 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 |