Méthode IDebugHostModule ::GetImageName (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 inclure ou non le chemin d’accès complet à l’image.
Syntaxe
HRESULT GetImageName(
bool allowPath,
BSTR *imageName
);
Paramètres
allowPath
Si la valeur est true, indique que le chemin d’accès complet au module peut être inclus dans la sortie. Le fait que ce chemin d’accès soit inclus ou non revient à 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 d’image du module sera inclus dans la sortie.
imageName
Le nom de l’image (ou chemin d’accès complet) du module sera retourné ici sous la forme d’une chaîne allouée. L’appelant est responsable de l’appel de SysFreeString pour libérer la chaîne après utilisation.
Valeur retournée
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);
}
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | dbgmodel.h |