Função SymGetSymPrev (dbghelp.h)

Artigo
03/05/2025

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

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

Sintaxe

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

Parâmetros

[in] hProcess

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

[in, out] Symbol

Um ponteiro para uma estrutura IMAGEHLP_SYMBOL64.

Valor de retorno

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

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

Observações

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 simples. 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 de suporte da plataforma atualizada. 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

Requisitos

Requisito	Valor
da Plataforma de Destino	Windows
cabeçalho	dbghelp.h
biblioteca	Dbghelp.lib
de DLL	Dbghelp.dll
redistribuível	DbgHelp.dll 5.1 ou posterior

Consulte também

do DbgHelp Functions

IMAGEHLP_SYMBOL64

SymGetSymFromAddr64

SymGetSymFromName64

SymGetSymNext64

SymInitialize

Compartilhar via