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 |