Función SymCleanup (dbghelp.h)
Desasigna todos los recursos asociados al identificador de proceso.
Sintaxis
BOOL IMAGEAPI SymCleanup(
[in] HANDLE hProcess
);
Parámetros
[in] hProcess
Identificador del proceso que se pasó originalmente a la función SymInitialize.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es TRUE.
Si se produce un error en la función, el valor devuelto es FALSE. Para recuperar información de error extendida, llame a GetLastError.
Observaciones
Esta función libera todos los recursos asociados al identificador de proceso. Si no se llama a esta función, se producen pérdidas de memoria y recursos en la aplicación que realiza la llamada.
Todas las funciones DbgHelp, como esta, son un solo subproceso. Por lo tanto, las llamadas de más de un subproceso a esta función probablemente provocarán un comportamiento inesperado o daños en la memoria. Para evitar esto, llame a SymInitialize solo cuando se inicie el proceso y SymCleanup solo cuando finalice el proceso. No es necesario que cada subproceso del proceso llame a estas funciones.
Ejemplos
Para obtener un ejemplo, vea Finalizar el controlador de símbolos.
Requisitos
Requisito | Valor |
---|---|
de la plataforma de destino de | Windows |
encabezado de | dbghelp.h |
biblioteca de | Dbghelp.lib |
DLL de | Dbghelp.dll |
redistribuible | DbgHelp.dll 5.1 o posterior |