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

Artigo
02/06/2025

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

Sintaxe

HRESULT GetModuleByModuleName2Wide(
  [in]            PCWSTR   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. 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 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

GetModuleByModuleName

IDebugSymbols3

Partilhar via