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

El método GetImageName devuelve el nombre de la imagen del módulo. Según el valor del argumento allowPath, el nombre de imagen devuelto puede incluir o no la ruta de acceso completa a la imagen.

Sintaxis

HRESULT GetImageName(
  bool allowPath,
  BSTR *imageName
);

Parámetros

allowPath

Si es true, indica que la ruta de acceso completa al módulo se puede incluir en la salida. Tanto si dicha ruta de acceso es o no está incluida es el host de depuración específico y la manera en que se cargó el módulo. Si es false, indica que solo se incluirá el nombre de imagen del módulo en la salida.

imageName

El nombre de la imagen (o ruta de acceso completa) del módulo se devolverá aquí como una cadena asignada. El autor de la llamada es responsable de llamar a SysFreeString para liberar la cadena después de su uso.

Valor devuelto

Este método devuelve HRESULT, que indica que se ha realizado correctamente o no.

Comentarios

Código de ejemplo

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
Header	dbgmodel.h

Consulte también

Interfaz IDebugHostModule