Funzione SymGetSymPrev (dbghelp.h)

Articolo
08/23/2023

Recupera le informazioni sui simboli per il simbolo precedente.

Nota Questa funzione viene fornita solo per la compatibilità. Le applicazioni devono usare SymPrev.

Sintassi

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

Parametri

[in] hProcess

Handle per il processo passato originariamente alla funzione SymInitialize .

[in, out] Symbol

Puntatore a una struttura IMAGEHLP_SYMBOL64 .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è TRUE.

Se la funzione ha esito negativo, il valore restituito è FALSE. Per recuperare informazioni sull'errore estese, chiamare GetLastError.

Commenti

La funzione SymGetSymPrev64 richiede che la struttura IMAGEHLP_SYMBOL64 disponga di dati validi, presumibilmente ottenuta da una chiamata alla funzione SymGetSymFromAddr64 o SymGetSymFromName64. Questa struttura viene compilata con le informazioni sul simbolo per il simbolo precedente in sequenza in base all'indirizzo virtuale.

Tutte le funzioni DbgHelp, ad esempio questa, sono a thread singolo. Pertanto, le chiamate da più thread a questa funzione potrebbero causare un comportamento imprevisto o un danneggiamento della memoria. Per evitare questo problema, è necessario sincronizzare tutte le chiamate simultanee da più thread a questa funzione.

Per chiamare la versione Unicode di questa funzione, definire DBGHELP_TRANSLATE_TCHAR. SymGetSymPrevW64 è definito come indicato di seguito in DbgHelp.h.

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

Questa funzione sostituisce la funzione SymGetSymPrev . Per altre informazioni, vedere Supporto della piattaforma aggiornato. SymGetSymPrev è definito come segue in 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

Requisiti


Piattaforma di destinazione	Windows
Intestazione	dbghelp.h
Libreria	Dbghelp.lib
DLL	Dbghelp.dll
Componente ridistribuibile	DbgHelp.dll 5.1 o versioni successive