Compartilhar via


Função SymGetFileLineOffsets64 (dbghelp.h)

Localiza informações de linha para o módulo e o nome do arquivo especificados.

Sintaxe

ULONG IMAGEAPI SymGetFileLineOffsets64(
  [in]           HANDLE   hProcess,
  [in, optional] PCSTR    ModuleName,
  [in]           PCSTR    FileName,
  [out]          PDWORD64 Buffer,
  [in]           ULONG    BufferLines
);

Parâmetros

[in] hProcess

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

[in, optional] ModuleName

O nome do módulo no qual as linhas devem ser localizadas. Se esse parâmetro for NULL, a função pesquisa todos os módulos.

[in] FileName

O nome do arquivo no qual as linhas devem ser localizadas.

[out] Buffer

Uma matriz de deslocamentos para cada linha. O deslocamento para a linha n é armazenado no elemento n-1. Elementos de matriz para linhas que não têm informações de linha permanecem inalterados.

[in] BufferLines

O tamanho da matriz buffer , em elementos .

Retornar valor

Se a função for bem-sucedida, o valor retornado será o número de linha mais alto encontrado. Esse valor será zero se nenhuma informação de linha tiver sido encontrada.

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

Comentários

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.

Requisitos

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

Confira também

Funções DbgHelp