IDebugHostModule2 ::GetImageName, méthode (dbgmodel.h)
La méthode GetImageName retourne le nom de l’image du module. Selon la valeur de l’argument allowPath, le nom de l’image retournée peut ou non inclure le chemin complet de l’image.
Syntaxe
HRESULT GetImageName(
bool allowPath,
BSTR *imageName
);
Paramètres
allowPath
Si la valeur est true, indique que le chemin complet du module peut être inclus dans la sortie. Si ce chemin d’accès est ou non inclus jusqu’à l’hôte de débogage spécifique et à la manière dont le module a été chargé. Si la valeur est false, indique que seul le nom de l’image du module sera inclus dans la sortie.
imageName
Le nom de l’image (ou chemin d’accès complet) du module est retourné ici sous forme de chaîne allouée. L’appelant est chargé d’appeler SysFreeString pour libérer la chaîne après l’utilisation.
Valeur de retour
Cette méthode retourne HRESULT qui indique la réussite ou l’échec.
Remarques
exemple de code
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);
}
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | dbgmodel.h |