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

Artigo
02/06/2025

O método GetModuleByModuleNameWide pesquisa por meio dos módulos do destino para um com o nome especificado.

Sintaxe

HRESULT GetModuleByModuleNameWide(
  [in]            PCWSTR   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 Name. 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 outros valores de erro. Consulte de 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.

Observações

A partir do índice especificado, esses métodos retornam o primeiro módulo encontrado 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 Modules.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	dbgeng.h (inclua Dbgeng.h)

Consulte também

GetModuleByModuleName2

IDebugSymbols3

Partilhar via