Auf Englisch lesen

Freigeben über


SymCleanup-Funktion (dbghelp.h)

Behandelt alle Ressourcen, die dem Prozesshandle zugeordnet sind.

Syntax

BOOL IMAGEAPI SymCleanup(
  [in] HANDLE hProcess
);

Parameter

[in] hProcess

Ein Handle an den Prozess, der ursprünglich an die SymInitialize-Funktion übergeben wurde.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE.

Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen abzurufen.

Bemerkungen

Diese Funktion gibt alle Ressourcen frei, die dem Prozesshandle zugeordnet sind. Fehler beim Aufrufen dieser Funktion verursachen Speicher- und Ressourcenverluste in der aufrufenden Anwendung.

Alle DbgHelp-Funktionen, z. B. diese, sind single threaded. Daher führen Aufrufe von mehr als einem Thread zu dieser Funktion wahrscheinlich zu unerwartetem Verhalten oder Speicherbeschädigung. Um dies zu vermeiden, rufen Sie SymInitialize nur dann auf, wenn der Prozess gestartet wird, und SymCleanup nur, wenn der Prozess endet. Für jeden Thread im Prozess ist es nicht erforderlich, diese Funktionen aufzurufen.

Beispiele

Ein Beispiel finden Sie unter Beenden des Symbolhandlers.

Anforderungen

Anforderung Wert
Zielplattform- Fenster
Header- dbghelp.h
Library Dbghelp.lib
DLL- Dbghelp.dll
redistributable DbgHelp.dll 5.1 oder höher

Siehe auch

DbgHelp-Funktionen

SymInitialize-