Método IDebugSymbols::GetModuleByModuleName (dbgeng.h)

Artigo
02/23/2024

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

Sintaxe

HRESULT GetModuleByModuleName(
  [in]            PCSTR    Name,
  [in]            ULONG    StartIndex,
  [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.

[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.