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

Artigo
02/06/2025

O método GetSymbolEntriesByOffset retorna os símbolos que estão localizados em um endereço especificado.

Sintaxe

HRESULT GetSymbolEntriesByOffset(
  [in]            ULONG64              Offset,
  [in]            ULONG                Flags,
  [out, optional] PDEBUG_MODULE_AND_ID Ids,
  [out, optional] PULONG64             Displacements,
  [in]            ULONG                IdsCount,
  [out, optional] PULONG               Entries
);

Parâmetros

[in] Offset

Especifica um local no espaço de endereço de memória do processo dentro do intervalo do símbolo desejado. Nem todos os símbolos têm um intervalo conhecido, portanto, para obter melhores resultados, use o endereço base do símbolo.

[in] Flags

Definido como zero.

[out, optional] Ids

Recebe os símbolos. Esta é uma matriz de entradas IdsCount do tipo DEBUG_MODULE_AND_ID. Se IDs estiver NULL, essas informações não serão retornadas.

[out, optional] Displacements

Recebe as diferenças entre os endereços base dos símbolos encontrados e o endereço fornecido de acordo com o intervalo do símbolo.

[in] IdsCount

Especifica o número de entradas que as matrizes IDs e deslocamentos podem conter.

[out, optional] Entries

Recebe o número de símbolos localizados em Deslocamento. Se Entradas for NULL, essas informações não serão retornadas.

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.

Observações

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)

Consulte também

GetSymbolEntriesByName

IDebugSymbols3

Partilhar via