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

Weitere Informationen

DbgHelp-Funktionen

SymInitialize