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

[アーティクル]
08/07/2023

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

構文

HRESULT OpenDumpFile(
  [in] PCSTR DumpFile
);

パラメーター

[in] DumpFile

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

戻り値

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

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

注釈

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

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

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