SymSetContext-Funktion (dbghelp.h)

Artikel
02/28/2024

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.