Método IDebugHostModule2::GetImageName (dbgmodel.h)

Artigo
02/06/2025

O método GetImageName retorna o nome da imagem do módulo. Dependendo do valor do argumento allowPath, o nome da imagem retornada pode ou não incluir o caminho completo para a imagem.

Sintaxe

HRESULT GetImageName(
  bool allowPath,
  BSTR *imageName
);

Parâmetros

allowPath

Se verdadeiro, indica que o caminho completo para o módulo pode ser incluído na saída. Se esse caminho está ou não incluído, cabe ao host de depuração específico e à maneira como o módulo foi carregado. Se false, indica que somente o nome da imagem do módulo será incluído na saída.

imageName

O nome da imagem (ou caminho completo) do módulo será retornado aqui como uma cadeia de caracteres alocada. O chamador é responsável por chamar SysFreeString para liberar a cadeia de caracteres após o uso.

Valor de retorno

Esse método retorna HRESULT que indica êxito ou falha.

Observações

de código de exemplo

ComPtr<IDebugHostModule> spModule; /* get a module (see FindModuleByName) */

BSTR imageName;
if (SUCCEEDED(spModule->GetImageName(false, &imageName)))
{
    // imageName is the name of the image (guaranteed not to have a path 
    // in it).  For instance, this might be "notepad.exe"
    SysFreeString(imageName);
}

Requisitos

Requisito	Valor
cabeçalho	dbgmodel.h

Consulte também

interface IDebugHostModule2

Compartilhar via