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

Artigo
08/07/2023

O método GetModuleNames retorna os nomes do módulo especificado.

Sintaxe

HRESULT GetModuleNames(
  [in]            ULONG   Index,
  [in]            ULONG64 Base,
  [out, optional] PSTR    ImageNameBuffer,
  [in]            ULONG   ImageNameBufferSize,
  [out, optional] PULONG  ImageNameSize,
  [out, optional] PSTR    ModuleNameBuffer,
  [in]            ULONG   ModuleNameBufferSize,
  [out, optional] PULONG  ModuleNameSize,
  [out, optional] PSTR    LoadedImageNameBuffer,
  [in]            ULONG   LoadedImageNameBufferSize,
  [out, optional] PULONG  LoadedImageNameSize
);

Parâmetros

[in] Index

Especifica o índice do módulo cujos nomes são solicitados. Se estiver definido como DEBUG_ANY_ID, o módulo será especificado por Base.

[in] Base

Especifica o endereço base do módulo cujos nomes são solicitados. Esse parâmetro só será usado se Index estiver definido como DEBUG_ANY_ID.

[out, optional] ImageNameBuffer

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

[in] ImageNameBufferSize

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

[out, optional] ImageNameSize

Recebe o tamanho em caracteres do nome da imagem. Esse tamanho inclui o espaço para o caractere de terminação '\0'. Se ImageNameSize for NULL, essas informações não serão retornadas.

[out, optional] ModuleNameBuffer

Recebe o nome do módulo. Esse tamanho inclui o espaço para o caractere de terminação '\0'. Se ModuleNameBuffer for NULL, essas informações não serão retornadas.

[in] ModuleNameBufferSize

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

[out, optional] ModuleNameSize

Recebe o tamanho em caracteres do nome do módulo. Esse tamanho inclui o espaço para o caractere de terminação '\0'. Se ModuleNameSize for NULL, essas informações não serão retornadas.

[out, optional] LoadedImageNameBuffer

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

[in] LoadedImageNameBufferSize

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

[out, optional] LoadedImageNameSize

Recebe o tamanho em caracteres do nome da imagem carregada. Esse tamanho inclui o espaço para o caractere de terminação '\0'. Se LoadedImageNameSize 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.
S_FALSE	O método foi bem-sucedido. No entanto, pelo menos um de ImageNameBuffer, ModuleNameBuffer ou LoadedImageNameBuffer era muito pequeno para o nome correspondente, portanto, ele foi truncado.
E_NOINTERFACE	O módulo especificado não foi encontrado.