Función SymGetSymPrev (dbghelp.h)

Artículo
08/23/2023

Recupera la información del símbolo del símbolo anterior.

Nota Esta función solo se proporciona por motivos de compatibilidad. Las aplicaciones deben usar SymPrev.

Sintaxis

BOOL IMAGEAPI SymGetSymPrev(
  [in]      HANDLE           hProcess,
  [in, out] PIMAGEHLP_SYMBOL Symbol
);

Parámetros

[in] hProcess

Identificador del proceso que se pasó originalmente a la función SymInitialize .

[in, out] Symbol

Puntero a una estructura de IMAGEHLP_SYMBOL64 .

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 SymGetSymPrev64 requiere que la estructura de IMAGEHLP_SYMBOL64 tenga datos válidos, presumiblemente obtenidos de una llamada a la función SymGetSymFromAddr64 o SymGetSymFromName64 . Esta estructura se rellena con la información de símbolos del símbolo anterior en secuencia por dirección virtual.

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. SymGetSymPrevW64 se define de la siguiente manera en DbgHelp.h.

BOOL
IMAGEAPI
SymGetSymPrevW64(
    __in HANDLE hProcess,
    __inout PIMAGEHLP_SYMBOLW64 Symbol
    );

Esta función sustituye a la función SymGetSymPrev . Para obtener más información, consulte Compatibilidad con la plataforma actualizada. SymGetSymPrev se define de la siguiente manera en Dbghelp.h.

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define SymGetSymPrev SymGetSymPrev64
#define SymGetSymPrevW SymGetSymPrevW64
#else
BOOL
IMAGEAPI
SymGetSymPrev(
    __in HANDLE hProcess,
    __inout PIMAGEHLP_SYMBOL Symbol
    );

BOOL
IMAGEAPI
SymGetSymPrevW(
    __in HANDLE hProcess,
    __inout PIMAGEHLP_SYMBOLW Symbol
    );
#endif