IDebugHostModule::GetImageName-Methode (dbgmodel.h)
Die GetImageName-Methode gibt den Imagenamen des Moduls zurück. Abhängig vom Wert des arguments allowPath kann der zurückgegebene Imagename den vollständigen Pfad zum Image enthalten oder nicht.
Syntax
HRESULT GetImageName(
bool allowPath,
BSTR *imageName
);
Parameter
allowPath
Wenn true, gibt an, dass der vollständige Pfad zum Modul in der Ausgabe enthalten sein kann. Ob ein solcher Pfad enthalten ist oder nicht, hängt vom jeweiligen Debughost und der Art und Weise ab, in der das Modul geladen wurde. Wenn false, gibt an, dass nur der Bildname des Moduls in die Ausgabe eingeschlossen wird.
imageName
Der Bildname (oder der vollständige Pfad) des Moduls wird hier als zugeordnete Zeichenfolge zurückgegeben. Der Aufrufer ist für den Aufruf von SysFreeString verantwortlich, um die Zeichenfolge nach der Verwendung frei zu geben.
Rückgabewert
Diese Methode gibt HRESULT zurück, das den Erfolg oder Fehler angibt.
Hinweise
Beispielcode
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);
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | dbgmodel.h |