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 Targets」を参照してください。

要件

要件 値
対象プラットフォーム デスクトップ
Header dbgeng.h (Dbgeng.h を含む)

こちらもご覧ください

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

IDebugClient4

IDebugClient5

WriteDumpFile2