次の方法で共有

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

  • [アーティクル]

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 ターゲット」を参照してください。

必要条件

要件 価値
ターゲット プラットフォーム の デスクトップ
ヘッダー dbgeng.h (Dbgeng.h を含む)

関連項目

.opendump (ダンプ ファイルを開く)

AddDumpInformationFile を する

AddDumpInformationFileWide の

IDebugClient4 の

IDebugClient5 の

OpenDumpFile