IDebugClient4::OpenDumpFileWide メソッド (dbgeng.h)

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

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

構文

HRESULT OpenDumpFileWide(
  [in, optional] PCWSTR  FileName,
  [in]           ULONG64 FileHandle
);

パラメーター

[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 を返します。

戻り値

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

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

注釈

このメソッドの ASCII バージョンは OpenDumpFile です。

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

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