Função SymGetSymPrev (dbghelp.h)

Artigo
08/23/2023

Recupera as informações de símbolo do símbolo anterior.

Nota Essa função é fornecida apenas para compatibilidade. Os aplicativos devem usar o SymPrev.

Sintaxe

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

Parâmetros

[in] hProcess

Um identificador para o processo que foi originalmente passado para a função SymInitialize .

[in, out] Symbol

Um ponteiro para uma estrutura IMAGEHLP_SYMBOL64 .

Valor retornado

Se a função for bem-sucedida, o valor retornado será TRUE.

Se a função falhar, o valor retornado será FALSE. Para recuperar informações de erro estendidas, chame GetLastError.

Comentários

A função SymGetSymPrev64 requer que a estrutura IMAGEHLP_SYMBOL64 tenha dados válidos, presumivelmente obtidos de uma chamada para a função SymGetSymFromAddr64 ou SymGetSymFromName64 . Essa estrutura é preenchida com as informações de símbolo do símbolo anterior em sequência por endereço virtual.

Todas as funções DbgHelp, como esta, são threaded único. Portanto, chamadas de mais de um thread para essa função provavelmente resultarão em comportamento inesperado ou corrupção de memória. Para evitar isso, você deve sincronizar todas as chamadas simultâneas de mais de um thread para essa função.

Para chamar a versão Unicode dessa função, defina DBGHELP_TRANSLATE_TCHAR. SymGetSymPrevW64 é definido da seguinte maneira em DbgHelp.h.

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

Essa função substitui a função SymGetSymPrev . Para obter mais informações, consulte Suporte de plataforma atualizado. SymGetSymPrev é definido da seguinte maneira em 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