SymCleanup-Funktion (dbghelp.h)
Behandelt alle Ressourcen, die dem Prozesshandle zugeordnet sind.
BOOL IMAGEAPI SymCleanup(
[in] HANDLE hProcess
);
[in] hProcess
Ein Handle an den Prozess, der ursprünglich an die SymInitialize-Funktion übergeben wurde.
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.
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.
Ein Beispiel finden Sie unter Beenden des Symbolhandlers.
Anforderung | Wert |
---|---|
Zielplattform- | Fenster |
Header- | dbghelp.h |
Library | Dbghelp.lib |
DLL- | Dbghelp.dll |
redistributable | DbgHelp.dll 5.1 oder höher |