IDebugHostModule2::GetImageName-Methode (dbgmodel.h)
Die GetImageName-Methode gibt den Bildnamen des Moduls zurück. Abhängig vom Wert des AllowPath-Arguments kann der zurückgegebene Bildname den vollständigen Pfad zum Bild enthalten.
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, liegt bei dem spezifischen Debughost und der Art und Weise, 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 dafür verantwortlich, sysFreeString aufzurufen, um die Zeichenfolge nach der Verwendung frei zu geben.
Rückgabewert
Diese Methode gibt HRESULT zurück, das Erfolg oder Fehler angibt.
Bemerkungen
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 |