Función SymGetSymNext (dbghelp.h)

Artículo
08/23/2023

Recupera la información del símbolo para el símbolo siguiente.

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

Sintaxis

BOOL IMAGEAPI SymGetSymNext(
  [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 SymGetSymNext64 requiere que la estructura de IMAGEHLP_SYMBOL64 tenga datos válidos, supuestamente obtenidos de una llamada a la función SymGetSymFromAddr64 o SymGetSymFromName64 . Esta estructura se rellena con la información de símbolos del siguiente símbolo 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. SymGetSymNextW64 se define de la siguiente manera en DbgHelp.h.

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

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

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define SymGetSymNext SymGetSymNext64
#define SymGetSymNextW SymGetSymNextW64
#else
BOOL
IMAGEAPI
SymGetSymNext(
    __in HANDLE hProcess,
    __inout PIMAGEHLP_SYMBOL Symbol
    );

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