Método IDebugHostModule2::GetImageName (dbgmodel.h)
El método GetImageName devuelve el nombre de 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. Si dicha ruta de acceso está o no 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 |