IDebugClient8::OpenDumpFileWide2 メソッド (dbgeng.h)
OpenDumpFileWide2 メソッドは、デバッガー ターゲットとしてダンプ ファイルを開きます。
構文
HRESULT OpenDumpFileWide2(
[in, optional] PCWSTR FileName,
[in] ULONG64 FileHandle,
[in] ULONG AlternateArch
);
パラメーター
[in, optional] FileName
開くダンプ ファイルの名前を指定します。FileHandle が 0 でない限り、fileName は、エンジンがダンプ ファイルの名前を照会する場合にのみ使用されます。 FileName には、ファイル名拡張子を含める必要があります。 FileName には、相対パスまたは絶対パスを含めることができます。相対パスは、デバッガーが開始されたディレクトリに対する相対パスです。 FileName は、"file://" から始まるファイル URL の形式にすることもできます。 FileName でキャビネット (.cab) ファイルが指定されている場合、キャビネット ファイルは拡張子が .kdmp、次に .hdmp、.mdmp、最後に.dmpされた最初のファイルを検索します。
[in] FileHandle
開くダンプ ファイルのファイル ハンドルを指定します。 FileHandle が 0 の場合、FileName を使用してダンプ ファイルが開きます。 それ以外の場合、fileName が NULL でない場合、エンジンはダンプ ファイルの名前を照会したときにそれを返します。 FileHandle が 0 ではなく、FileName が NULL 場合、エンジンはファイル名 HandleOnly を返します。
[in] AlternateArch
IMAGE_FILE_MACHINE_* 定数である AlternateArch 引数を指定します。 詳細については、「イメージ ファイル マシン定数 」を参照してください。
これら 2 つの定数がサポートされています。
IMAGE_FILE_MACHINE_AMD64: イメージが x64 プロセスで実行されているかのように読み込む
IMAGE_FILE_MACHINE_ARM64: イメージが ARM64 プロセスで実行されているかのように読み込む
このパラメーターは、OpenDumpFileWide2 を使用して、異なるアーキテクチャにマップできるイメージ ファイル (ダンプ ファイルではない) を開く場合にのみ関連します。 たとえば、X64/EC プロセスまたは ARM64 プロセスに DLL を読み込むことができる ARM64X などです。
既定では、DLL に関する情報は、イメージ ヘッダーが定義したアーキテクチャを使用して表示されます。 別のアーキテクチャで OpenDumpFileWide2 を呼び出すと、渡されたアーキテクチャを使用して情報が表示されます。 これにより、DLL がそのプロセスのアーキテクチャに読み込まれた場合に OS が適用した "修正" を確認できます。
ARM64X の詳細については、arm64X PE ファイル を参照してください。
戻り値
このメソッドは、エラー値を返す場合もあります。 詳細については 戻り値の を参照してください。
備考
WaitForEvent メソッドが呼び出されるまで、エンジンはダンプ ファイルに完全にアタッチされません。 プロセスまたはカーネルからダンプ ファイルが作成されると、最後のイベントに関する情報がダンプ ファイルに格納されます。 ダンプ ファイルが開かれた後、次回の実行が試行されると、エンジンによってイベント コールバックに対してこのイベントが生成されます。 その場合にのみ、デバッグ セッションでダンプ ファイルが使用できるようになります。
クラッシュ ダンプ ファイルの詳細については、「Dump-File ターゲット」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | ウィンドウズ |
| ヘッダー | dbgeng.h (Dbgeng.h を含む) |
関連項目
IDebugClient8 の