IDebugClient2::OpenDumpFile メソッド (dbgeng.h)

[アーティクル]
02/26/2024

OpenDumpFile メソッドは、デバッガーターゲットとしてダンプファイルを開きます。

構文

HRESULT OpenDumpFile(
  [in] PCSTR DumpFile
);

パラメーター

[in] DumpFile

開くダンプファイルの名前を指定します。 DumpFile には 、ファイル名拡張子を含める必要があります。 DumpFile には、相対パスまたは絶対パスを含めることができます。相対パスは、デバッガーが開始されたディレクトリに対する相対パスです。 DumpFile には、"file://" から始まるファイル URL の形式を指定できます。 DumpFile でキャビネット (.cab) ファイルが指定されている場合、キャビネットファイルは拡張子が .kdmp、.hdmp、.mdmp の 1 つ目のファイルを検索し、最後に.dmp。

戻り値

このメソッドは、エラー値を返す場合もあります。詳細については、「戻り値」を参照してください。

リターンコード	説明
S_OK	メソッドは正常に実行されました。

注釈

このメソッドの Unicode バージョンは OpenDumpFileWide です。

メモWaitForEvent メソッドが呼び出されるまで、エンジンはダンプファイルに完全にアタッチしません。プロセスまたはカーネルからダンプファイルが作成されると、最後のイベントに関する情報がダンプファイルに格納されます。ダンプファイルが開かれた後、次回の実行が試行されると、エンジンによってイベントコールバックに対してこのイベントが生成されます。その場合にのみ、デバッグセッションでダンプファイルが使用できるようになります。

クラッシュダンプファイルの詳細については、「 Dump-File Targets」を参照してください。