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

Artigo
02/26/2024

O método GetModuleByOffset2 pesquisa por módulos do processo um cuja alocação de memória inclui o local especificado.

Sintaxe

HRESULT GetModuleByOffset2(
  [in]            ULONG64  Offset,
  [in]            ULONG    StartIndex,
  [in]            ULONG    Flags,
  [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 que pertence ao módulo.

[in] StartIndex

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

[in] Flags

Especifica um conjunto de bits que contém opções usadas ao pesquisar o módulo com o local especificado. Os sinalizadores podem conter os seguintes sinalizadores de bit:

Sinalizador	Efeito
DEBUG_GETMOD_NO_LOADED_MODULES	Não pesquise os módulos carregados.
DEBUG_GETMOD_NO_UNLOADED_MODULES	Não pesquise os módulos descarregados.

[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

Começando no índice especificado, esse método retorna o primeiro módulo encontrado 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 inclua 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.