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

Artigo
02/23/2024

O método GetModuleByOffset pesquisa os módulos do destino para um cuja alocação de memória inclui o local especificado.

Sintaxe

HRESULT GetModuleByOffset(
  [in]            ULONG64  Offset,
  [in]            ULONG    StartIndex,
  [out, optional] PULONG   Index,
  [out, optional] PULONG64 Base
);

Parâmetros

[in] Offset

Especifica um local no espaço de endereço virtual do destino que está dentro da alocação de memória do módulo desejado , por exemplo, o endereço de um símbolo pertencente ao módulo.

[in] StartIndex

Especifica o índice do qual começar a pesquisar.

[out, optional] Index

Recebe o índice do módulo. Se Index for NULL, essas informações não serão retornadas.

[out, optional] Base

Recebe o local no espaço de endereço de memória do destino da base do módulo. Se Base 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

A partir do índice especificado, esse método retorna o primeiro módulo que encontra cujo intervalo de endereços de alocação de memória inclui o local especificado. Se o destino tiver mais de um módulo cujo intervalo de endereços de memória inclui esse local, os módulos subsequentes poderão ser encontrados por chamadas repetidas para esse método com valores mais altos de StartIndex.

Para obter mais informações sobre módulos, consulte Módulos.