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

Retorna todas as regiões de memória conhecidas por serem associadas a um símbolo.

Sintaxe

HRESULT GetSymbolEntryOffsetRegions(
  [in]            PDEBUG_MODULE_AND_ID Id,
  [in]            ULONG                Flags,
  [out]           PDEBUG_OFFSET_REGION Regions,
  [in]            ULONG                RegionsCount,
  [out, optional] PULONG               RegionsAvail
);

Parâmetros

[in] Id

A ID de um módulo como um ponteiro para uma estrutura DEBUG_MODULE_AND_ID .

[in] Flags

Um conjunto de bits que contém opções que afetam o comportamento desse método.

[out] Regions

As regiões de memória associadas ao símbolo.

[in] RegionsCount

O número de regiões associadas ao símbolo.

[out, optional] RegionsAvail

Um ponteiro para o número de regiões disponíveis para o símbolo.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Essa função retorna todas as regiões de memória conhecidas associadas a um símbolo especificado. Símbolos simples têm uma única região que começa a partir de sua base. Regiões mais complicadas, como funções que têm várias áreas de código, podem ter um número arbitrariamente grande de regiões.

A qualidade das informações retornadas depende muito das informações simbólicas disponíveis.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho dbgeng.h (inclua Dbgeng.h)

Confira também

DEBUG_MODULE_AND_ID

IDebugSymbols3

IDebugSymbols3::GetSourceEntryOffsetRegions