Condividi tramite


Metodo IDebugHostModule3::GetImageName (dbgmodel.h)

Il metodo GetImageName restituisce il nome dell'immagine del modulo. A seconda del valore dell'argomento allowPath, il nome dell'immagine restituita può includere o meno il percorso completo dell'immagine.

Sintassi

HRESULT GetImageName(
  bool allowPath,
  BSTR *imageName
);

Parametri

allowPath

Se true, indica che il percorso completo del modulo può essere incluso nell'output. Se tale percorso è o non è incluso è fino all'host di debug specifico e al modo in cui è stato caricato il modulo. Se false, indica che nell'output verrà incluso solo il nome dell'immagine del modulo.

imageName

Il nome dell'immagine (o il percorso completo) del modulo verrà restituito qui come stringa allocata. Il chiamante è responsabile della chiamata a SysFreeString per liberare la stringa dopo l'uso.

Valore restituito

Questo metodo restituisce HRESULT che indica l'esito positivo o negativo.

Osservazioni

codice di esempio

ComPtr<IDebugHostModule3> 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);
}

Fabbisogno

Requisito Valore
intestazione dbgmodel.h

Vedere anche

'interfaccia IDebugHostModule3