Compartilhar via

Função SymGetLineFromInlineContext (dbghelp.h)

  • Artigo

Localiza a linha de origem para o contexto embutido especificado.

Sintaxe

BOOL IMAGEAPI SymGetLineFromInlineContext(
  [in]           HANDLE           hProcess,
  [in]           DWORD64          qwAddr,
  [in]           ULONG            InlineContext,
  [in, optional] DWORD64          qwModuleBaseAddress,
  [out]          PDWORD           pdwDisplacement,
  [out]          PIMAGEHLP_LINE64 Line64
);

Parâmetros

[in] hProcess

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

[in] qwAddr

O endereço para o qual uma linha deve estar localizada. Não é necessário que o endereço esteja em um limite de linha. Se o endereço aparecer após o início de uma linha e antes do final da linha, a linha será encontrada.

[in] InlineContext

O contexto embutido.

[in, optional] qwModuleBaseAddress

O endereço base do módulo.

[out] pdwDisplacement

O deslocamento em bytes desde o início da linha ou zero.

[out] Line64

Um ponteiro para uma estrutura IMAGEHLP_LINE64 .

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

O chamador deve alocar o buffer de linha corretamente e preencher os membros necessários da estrutura IMAGEHLP_LINE64 antes de chamar SymGetLineFromInlineContext.

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

BOOL
IMAGEAPI
SymGetLineFromInlineContextW(
    _In_ HANDLE hProcess,
    _In_ DWORD64 dwAddr,
    _In_ ULONG InlineContext,
    _In_opt_ DWORD64 qwModuleBaseAddress,
    _Out_ PDWORD pdwDisplacement,
    _Out_ PIMAGEHLP_LINEW64 Line
    );

#ifdef DBGHELP_TRANSLATE_TCHAR
 #define SymGetLineFromInlineContext SymGetLineFromInlineContextW
#endif

Requisitos

   
Plataforma de Destino Windows
Cabeçalho dbghelp.h
Biblioteca DbgHelp.lib
DLL DbgHelp.dll
Redistribuível DbgHelp.dll 6.2 ou posterior