Função SymGetLinePrev (dbghelp.h)

Artigo
02/27/2024

Recupera as informações de linha da linha de origem anterior.

Sintaxe

BOOL IMAGEAPI SymGetLinePrev(
  [in]      HANDLE         hProcess,
  [in, out] PIMAGEHLP_LINE Line
);

Parâmetros

[in] hProcess

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

[in, out] Line

Um ponteiro para uma estrutura IMAGEHLP_LINE64 .

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 SymGetLinePrev64 requer que a estrutura IMAGEHLP_LINE64 tenha dados válidos, presumivelmente obtidos de uma chamada para a função SymGetLineFromAddr64 ou SymGetLineFromName64 . Essa estrutura é preenchida com as informações de linha da linha anterior em sequência.

Essa função retorna um ponteiro para um buffer que pode ser reutilizado por outra função. Portanto, copie os dados retornados para outro buffer imediatamente.

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. SymGetLinePrevW64 é definido da seguinte maneira em DbgHelp.h.

BOOL
IMAGEAPI
SymGetLinePrevW64(
    __in HANDLE hProcess,
    __inout PIMAGEHLP_LINEW64 Line
    );

#ifdef DBGHELP_TRANSLATE_TCHAR
#define SymGetLinePrev64    SymGetLinePrevW64
#endif

Essa função substitui a função SymGetLinePrev . Para obter mais informações, consulte Suporte de plataforma atualizado. SymGetLinePrev é definido da seguinte maneira em DbgHelp.h.

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define SymGetLinePrev SymGetLinePrev64
#else
BOOL
IMAGEAPI
SymGetLinePrev(
    __in HANDLE hProcess,
    __inout PIMAGEHLP_LINE Line
    );

BOOL
IMAGEAPI
SymGetLinePrevW(
    __in HANDLE hProcess,
    __inout PIMAGEHLP_LINEW Line
    );
#endif