Metodo IDebugHostModule::GetImageName (dbgmodel.h)
Il metodo GetImageName restituisce il nome dell'immagine del modulo. A seconda del valore dell'argomento allowPath, il nome dell'immagine restituito può o meno includere 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 alla modalità in cui è stato caricato il modulo. Se false, indica che solo il nome dell'immagine del modulo verrà incluso nell'output.
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 l'errore.
Commenti
Codice di esempio
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);
}
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | dbgmodel.h |