次の方法で共有


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

WriteDumpFileWide メソッドは、ユーザー モードまたはカーネル モードのダンプ ファイルを作成します。

構文

HRESULT WriteDumpFileWide(
  [in, optional] PCWSTR  FileName,
  [in]           ULONG64 FileHandle,
  [in]           ULONG   Qualifier,
  [in]           ULONG   FormatFlags,
  [in, optional] PCWSTR  Comment
);

パラメーター

[in, optional] FileName

作成するダンプ ファイルの名前を指定します。 FileName には、ファイル名拡張子を含める必要があります。 FileName には、相対パスまたは絶対パスを含めることができます。相対パスは、デバッガーが開始されたディレクトリに対する相対パスです。 FileHandle が NULL されていない場合、FileName は無視されます (デバッガー コンソールにステータス メッセージを書き込む場合を除きます)。

[in] FileHandle

クラッシュ ダンプを書き込むファイルのファイル ハンドルを指定します。 FileHandle が NULL 場合は、代わりに fileName で指定されたファイルが使用されます。

[in] Qualifier

作成するダンプの種類を指定します。 使用可能な値については、DEBUG_DUMP_XXXを参照してください。

[in] FormatFlags

ダンプ ファイルの形式を決定するフラグを指定し、ユーザー モードのミニダンプの場合は、ファイルに含める情報を指定します。 詳細については、DEBUG_FORMAT_XXXを参照してください。

[in, optional] Comment

クラッシュ ダンプ ファイルに含めるコメント文字列を指定します。 この文字列は、ダンプ ファイルが読み込まれるとデバッガー コンソールに表示されます。

戻り値

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

リターン コード 形容
S_OK
メソッドが成功しました。

備考

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

必要条件

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

関連項目

.dump (ダンプ ファイルの作成) する

IDebugClient4

IDebugClient5

WriteDumpFile2