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

Artigo
02/06/2025

O método GetFunctionEntryByOffset retorna as informações de entrada de função para 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::GetSymbolOffsete o valor do campo deslocamento 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 buffer.

[out, optional] BufferNeeded

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

Valor de retorno

Esse método também pode retornar valores de erro. Consulte de 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 manter as informações de entrada da 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 local Deslocamento.

Observações

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

Observação 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 Symbols.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	dbgeng.h (inclua Dbgeng.h, Winnt.h)

Consulte também

DEBUG_SYMBOL_ENTRY

GetNextSymbolMatch

IDebugSymbolGroup::GetSymbolOffset

IDebugSymbols3

Partilhar via