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
クラッシュ ダンプ ファイルに含めるコメント文字列を指定します。 この文字列は、ダンプ ファイルが読み込まれるときにデバッガー コンソールに表示されます。
戻り値
このメソッドは、エラー値を返す場合もあります。 詳細については、「 戻り値 」を参照してください。
リターン コード | 説明 |
---|---|
|
メソッドは正常に実行されました。 |
注釈
クラッシュ ダンプ ファイルの詳細については、「 Dump-File Targets」を参照してください。
要件
要件 | 値 |
---|---|
対象プラットフォーム | デスクトップ |
Header | dbgeng.h (Dbgeng.h を含む) |