IDebugHostModule::GetImageName メソッド (dbgmodel.h)
GetImageName メソッドは、モジュールのイメージ名を返します。 allowPath 引数の値によっては、返されるイメージ名にイメージへの完全なパスが含まれている場合と含まれていない場合があります。
構文
HRESULT GetImageName(
bool allowPath,
BSTR *imageName
);
パラメーター
allowPath
true の場合、モジュールへの完全なパスが出力に含まれる可能性があることを示します。 そのようなパスが含まれているか含まれていないかは、特定のデバッグ ホストとモジュールが読み込まれた方法に応じ得る。 false の場合、モジュールのイメージ名のみが出力に含まれることを示します。
imageName
モジュールのイメージ名 (または完全なパス) は、ここで割り当てられた文字列として返されます。 呼び出し元は、SysFreeString を呼び出して、使用後に文字列を解放する役割を担います。
戻り値
このメソッドは、成功または失敗を示す HRESULT を返します。
注釈
サンプル コード
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);
}
要件
要件 | 値 |
---|---|
Header | dbgmodel.h |