Función SymPrev (dbghelp.h)

Artículo
08/23/2023

Recupera información de símbolos para el símbolo anterior.

Sintaxis

BOOL IMAGEAPI SymPrev(
  [in]      HANDLE       hProcess,
  [in, out] PSYMBOL_INFO si
);

Parámetros

[in] hProcess

Identificador de un proceso. Este identificador debe haberse pasado previamente a la función SymInitialize .

[in, out] si

Puntero a una estructura de SYMBOL_INFO que proporciona información sobre el símbolo actual. Tras la devolución, la estructura contiene información sobre el símbolo anterior.

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

Esta función requiere que la estructura de SYMBOL_INFO tenga datos válidos para el símbolo actual. El símbolo anterior es el símbolo con una dirección virtual que precede inmediatamente a este símbolo.

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.