Función SymRegisterCallback (dbghelp.h)
Registra una función de devolución de llamada para que la use el controlador de símbolos.
Sintaxis
BOOL IMAGEAPI SymRegisterCallback(
[in] HANDLE hProcess,
[in] PSYMBOL_REGISTERED_CALLBACK CallbackFunction,
[in] PVOID UserContext
);
Parámetros
[in] hProcess
Identificador del proceso que se pasó originalmente a la función SymInitialize .
[in] CallbackFunction
Una función de devolución de llamada SymRegisterCallbackProc64 .
[in] UserContext
Valor definido por el usuario o NULL. Este valor se pasa simplemente a la función de devolución de llamada. Normalmente, una aplicación usa este parámetro para pasar un puntero a una estructura de datos que permite que la función de devolución de llamada establezca algún contexto.
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.
Comentarios
La función SymRegisterCallback64 permite a una aplicación registrar una función de devolución de llamada para que la use el controlador de símbolos. El controlador de símbolos llama a la función de devolución de llamada registrada cuando hay información de estado o progreso para la aplicación.
Todas las funciones DbgHelp, como esta, son un único subproceso. Por lo tanto, es probable que las llamadas desde más de un subproceso a esta función producirán un comportamiento inesperado o daños en la memoria. Para evitarlo, debe sincronizar todas las llamadas simultáneas de más de un subproceso a esta función.
Para llamar a la versión Unicode de esta función, defina DBGHELP_TRANSLATE_TCHAR. SymRegisterCallbackW64 se define de la siguiente manera en Dbghelp.h.
BOOL
IMAGEAPI
SymRegisterCallbackW64(
__in HANDLE hProcess,
__in PSYMBOL_REGISTERED_CALLBACK64 CallbackFunction,
__in ULONG64 UserContext
);
#ifdef DBGHELP_TRANSLATE_TCHAR
#define SymRegisterCallback64 SymRegisterCallbackW64
#endif
Esta función sustituye a la función SymRegisterCallback . Para obtener más información, consulte Compatibilidad con la plataforma actualizada. SymRegisterCallback se define de la siguiente manera en Dbghelp.h.
#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define SymRegisterCallback SymRegisterCallback64
#else
BOOL
IMAGEAPI
SymRegisterCallback(
__in HANDLE hProcess,
__in PSYMBOL_REGISTERED_CALLBACK CallbackFunction,
__in_opt PVOID UserContext
);
#endif
Para obtener un ejemplo más extenso, lea Obtención de notificaciones.
Requisitos
Requisito | Value |
---|---|
Plataforma de destino | Windows |
Encabezado | dbghelp.h |
Library | Dbghelp.lib |
Archivo DLL | Dbghelp.dll |
Redistribuible | DbgHelp.dll 5.1 o posterior |
Consulte también
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de