Método IDebugSymbols3::GetModuleByOffset2 (dbgeng.h)
O método GetModuleByOffset2 pesquisa por meio dos módulos de do processo para 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. sinalizadores podem conter os seguintes sinalizadores de bits:
| Bandeira | 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 de índice 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.
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 |
|---|---|
|
O método foi bem-sucedido. |
Observações
A partir do í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 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 Modules.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | dbgeng.h (inclua Dbgeng.h) |