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

Artigo
02/06/2025

O método GetModuleNameString retorna o nome do módulo especificado.

Sintaxe

HRESULT GetModuleNameString(
  [in]            ULONG   Which,
  [in]            ULONG   Index,
  [in]            ULONG64 Base,
  [out, optional] PSTR    Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  NameSize
);

Parâmetros

[in] Which

Especifica quais dos nomes do módulo a serem retornados, os valores possíveis são:

Valor	Descrição
DEBUG_MODNAME_IMAGE	O nome da imagem. Esse é o nome do arquivo executável, incluindo a extensão. Normalmente, o caminho completo é incluído no modo de usuário, mas não no modo kernel.
DEBUG_MODNAME_MODULE	O nome do módulo. Geralmente, esse é apenas o nome do arquivo sem a extensão. Em alguns casos, o nome do módulo difere significativamente do nome do arquivo.
DEBUG_MODNAME_LOADED_IMAGE	O nome da imagem carregada. A menos que os símbolos do Microsoft CodeView estejam presentes, isso é o mesmo que o nome da imagem.
DEBUG_MODNAME_SYMBOL_FILE	O nome do arquivo de símbolo. O caminho e o nome do arquivo de símbolo. Se nenhum símbolo tiver sido carregado, esse será o nome do arquivo executável.
DEBUG_MODNAME_MAPPED_IMAGE	O nome da imagem mapeada. Na maioria dos casos, isso é NULL . Se o depurador estiver mapeando um arquivo de imagem (por exemplo, durante a depuração de minidump), esse será o nome da imagem mapeada.

[in] Index

Especifica o índice do módulo. Se for definido como DEBUG_ANY_ID, o parâmetro Base será usado para especificar o local do módulo.

[in] Base

Se índice for DEBUG_ANY_ID, especifica o local no espaço de endereço de memória do destino da base do módulo. Caso contrário, ele será ignorado.

[out, optional] Buffer

Recebe o nome do módulo. Se buffer for NULL, essas informações não serão retornadas.

[in] BufferSize

Especifica o tamanho em caracteres do buffer buffer. Esse tamanho inclui o espaço para o caractere de terminação '\0'.

[out, optional] NameSize

Recebe o tamanho em caracteres do nome do módulo. Esse tamanho inclui o espaço para o caractere de terminação '\0'. Se NameSize 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
S_OK	O método foi bem-sucedido.
S_FALSE	O método foi bem-sucedido. No entanto, o tamanho do buffer era menor do que o tamanho do nome do módulo, portanto, ele foi truncado para caber no buffer.

Observações

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

GetModuleNames

IDebugSymbols2

IDebugSymbols3

Compartilhar via