Share via

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

  • Artigo

O método GetModuleByModuleName2 pesquisa os módulos do processo para um com o nome especificado.

Sintaxe

HRESULT GetModuleByModuleName2(
  [in]            PCSTR    Name,
  [in]            ULONG    StartIndex,
  [in]            ULONG    Flags,
  [out, optional] PULONG   Index,
  [out, optional] PULONG64 Base
);

Parâmetros

[in] Name

Especifica o nome do módulo desejado.

[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 nome 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 primeiro módulo com o nome Nome. 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 outros valores de erro. Consulte Valores retornados para obter mais detalhes.

Código de retorno Descrição
S_OK
 O método foi bem-sucedido.
E_INVALIDARG
 Um dos argumentos passados era inválido.

Comentários

Começando no índice especificado, esses métodos retornam o primeiro módulo que encontram com o nome especificado. Se o destino tiver mais de um módulo com esse nome, os módulos subsequentes poderão ser encontrados por chamadas repetidas para esses métodos com valores mais altos de StartIndex.

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

Requisitos

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

Confira também

GetModuleByModuleName

IDebugSymbols3