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

  • Artigo

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 qual dos nomes do módulo retornar, 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 estiver definido como DEBUG_ANY_ID, o parâmetro Base será usado para especificar o local do módulo.

[in] Base

Se Index for DEBUG_ANY_ID, especificará 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 de 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.

Retornar valor

Esse método também pode retornar valores de erro. Consulte 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 que o tamanho do nome do módulo, portanto, ele foi truncado para caber no buffer.

Comentários

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

GetModuleNames

IDebugSymbols2

IDebugSymbols3