Função SymGetSymNext (dbghelp.h)

Artigo
02/28/2024

Recupera as informações de símbolo para o próximo símbolo.

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

Sintaxe

BOOL IMAGEAPI SymGetSymNext(
  [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 .

Retornar valor

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 SymGetSymNext64 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 para o próximo símbolo 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. SymGetSymNextW64 é definido da seguinte maneira em DbgHelp.h.

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

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