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

O método GetSymbolEntriesByOffset retorna os símbolos 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

Defina como zero.

[out, optional] Ids

Recebe os símbolos. Essa é uma matriz de entradas IdsCount do tipo DEBUG_MODULE_AND_ID. Se Ids for 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 IDs de matrizes e deslocamentos podem conter.

[out, optional] Entries

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

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.

Comentários

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

Requisitos

Requisito	Valor
Plataforma de Destino	Área de Trabalho
Cabeçalho	dbgeng.h (inclua Dbgeng.h)

Confira também

GetSymbolEntriesByName

IDebugSymbols3