SymCleanup-Funktion (dbghelp.h)
Gibt die Zuordnung aller Ressourcen auf, die dem Prozesshandle zugeordnet sind.
Syntax
BOOL IMAGEAPI SymCleanup(
[in] HANDLE hProcess
);
Parameter
[in] hProcess
Ein Handle für 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 GetLastError auf, um erweiterte Fehlerinformationen abzurufen.
Hinweise
Diese Funktion gibt alle Ressourcen frei, die dem Prozesshandle zugeordnet sind. Der Fehler beim Aufrufen dieser Funktion führt zu Arbeitsspeicher- und Ressourcenverlusten in der aufrufenden Anwendung.
Alle DbgHelp-Funktionen, z. B. diese, sind singlethreaded. Daher führen an diese Funktion gerichtete Aufrufe mehrerer Threads wahrscheinlich zu unerwartetem Verhalten oder einer Beschädigung des Speichers. Um dies zu vermeiden, rufen Sie SymInitialize nur auf, wenn Der Prozess gestartet wird, und SymCleanup nur, wenn der Prozess endet. Es ist nicht erforderlich, dass jeder Thread im Prozess diese Funktionen aufruft.
Beispiele
Ein Beispiel finden Sie unter Beenden des Symbolhandlers.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | dbghelp.h |
| Bibliothek | Dbghelp.lib |
| DLL | Dbghelp.dll |
| Verteilbare Komponente | DbgHelp.dll 5.1 oder höher |