Método IDebugSymbols3::GetFunctionEntryByOffset (dbgeng.h)

Artigo
02/26/2024

O método GetFunctionEntryByOffset retorna as informações de entrada de função de uma função.

Sintaxe

HRESULT GetFunctionEntryByOffset(
  [in]            ULONG64 Offset,
  [in]            ULONG   Flags,
  [out, optional] PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  BufferNeeded
);

Parâmetros

[in] Offset

Especifica um local no espaço de endereço virtual do processo atual da implementação da função. Esse é o valor retornado no parâmetro Offset de GetNextSymbolMatch e IDebugSymbolGroup::GetSymbolOffset e o valor do campo Offset na estrutura DEBUG_SYMBOL_ENTRY .

[in] Flags

Especifica um sinalizador de bits que altera o comportamento desse método. Se o bit DEBUG_GETFNENT_RAW_ENTRY_ONLY não estiver definido, o mecanismo fornecerá entradas artificiais para casos conhecidos. Se esse bit for definido, as entradas artificiais não serão usadas.

[out, optional] Buffer

Recebe as informações de entrada da função. Se o processador efetivo for um x86, essa será a estrutura FPO_DATA para a função. Para todas as outras arquiteturas, essa é a estrutura IMAGE_FUNCTION_ENTRY para essa arquitetura.

[in] BufferSize

Especifica o tamanho do Buffer de buffer.

[out, optional] BufferNeeded

Especifica o tamanho das informações de entrada da função.

Retornar valor

Esse método também pode retornar valores de erro. Consulte Valores retornados para obter mais detalhes.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
S_FALSE	O método foi bem-sucedido, mas o buffer não era grande o suficiente para conter as informações de entrada de função e, portanto, as informações foram truncadas para caber.
E_NOINTERFACE	Nenhuma informação de entrada de função foi encontrada para o Deslocamento de localização.

Comentários

As estruturas FPO_DATA e IMAGE_FUNCTION_ENTRY estão documentadas em "Biblioteca de Ajuda de Imagem" incluída em Ferramentas de Depuração para Windows no arquivo DbgHelp.chm.

Nota As funções em "Biblioteca de Ajuda de Imagem" e "Biblioteca de Ajuda de Depuração", documentadas em DbgHelp.chm, não devem ser chamadas por nenhum aplicativo de mecanismo de extensão ou depurador.

Para obter mais informações sobre símbolos, consulte Símbolos.