次の方法で共有


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

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

構文

HRESULT WriteDumpFile2(
  [in]           PCSTR DumpFile,
  [in]           ULONG Qualifier,
  [in]           ULONG FormatFlags,
  [in, optional] PCSTR Comment
);

パラメーター

[in] DumpFile

作成するダンプ ファイルの名前を指定します。 DumpFile には 、ファイル名拡張子を含める必要があります。 DumpFile には、相対パスまたは絶対パスを含めることができます。相対パスは、デバッガーが開始されたディレクトリに対する相対パスです。

[in] Qualifier

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

[in] FormatFlags

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

[in, optional] Comment

クラッシュ ダンプ ファイルに含めるコメント文字列を指定します。 この文字列は、ダンプ ファイルが読み込まれるときにデバッガー コンソールに表示されます。 一部のダンプ ファイル形式では、コメント文字列の格納がサポートされていません。

戻り値

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

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

注釈

DEBUG_FORMAT_XXX ビット フラグは 、WriteDumpFile2 および WriteDumpFileWide によって、クラッシュ ダンプ ファイルの形式と、ユーザー モードのミニダンプの場合、ファイルに含める情報を決定するために使用されます。

次のビット フラグは、すべてのクラッシュ ダンプ ファイルに適用されます。

説明
DEBUG_FORMAT_WRITE_CAB クラッシュ ダンプ ファイルを CAB ファイルにパッケージ化します。 CAB ファイルには、指定されたファイル名またはファイル ハンドルが使用されます。クラッシュ ダンプは、CAB ファイルに移動される前に、最初に一時ファイルに作成されます。
DEBUG_FORMAT_CAB_SECONDARY_FILES
CAB ファイルに現在のシンボルとマップされたイメージを含めます。
DEBUG_FORMAT_WRITE_CABが設定されていない場合、このフラグは無視されます。
DEBUG_FORMAT_NO_OVERWRITE 既存のファイルを上書きしないでください。
 

ユーザー モードのミニダンプには、次のビット フラグを含めることもできます。

説明
DEBUG_FORMAT_USER_SMALL_FULL_MEMORY 完全メモリ データを追加します。 ターゲット アプリケーションが所有するすべてのアクセス可能なコミット済みページが含まれます。
DEBUG_FORMAT_USER_SMALL_HANDLE_DATA ターゲット アプリケーションに関連付けられているハンドルに関するデータを追加します。
DEBUG_FORMAT_USER_SMALL_UNLOADED_MODULES アンロードされたモジュール情報を追加します。 この情報は、Windows Server 2003 以降のバージョンの Windows でのみ使用できます。
DEBUG_FORMAT_USER_SMALL_INDIRECT_MEMORY 間接メモリを追加します。 スタックまたはバッキング ストア上のポインターによって参照されるアドレスを囲むメモリの小さな領域が含まれます。
DEBUG_FORMAT_USER_SMALL_DATA_SEGMENTS 実行可能イメージ内のすべてのデータ セグメントを追加します。
DEBUG_FORMAT_USER_SMALL_FILTER_MEMORY スタックトレースを再作成するのに役立たないバッキングストア内のスタック上のすべてのメモリをゼロに設定します。 これにより、不要な情報を削除することで、ミニダンプの圧縮効率を高め、プライバシーを向上させることができます。
DEBUG_FORMAT_USER_SMALL_FILTER_PATHS モジュールのパスを削除し、モジュール名のみを残します。 これは、ディレクトリ構造 (ユーザーの名前が含まれている可能性があります) を非表示にしてプライバシーを保護する場合に便利です。
DEBUG_FORMAT_USER_SMALL_PROCESS_THREAD_DATA プロセス環境ブロック (PEB) とスレッド環境ブロック (TEB) を追加します。 このフラグは、スレッドとプロセスの Windows システム情報を提供するために使用できます。
DEBUG_FORMAT_USER_SMALL_PRIVATE_READ_WRITE_MEMORY コミットされたすべてのプライベート読み取り/書き込みメモリ ページを追加します。
DEBUG_FORMAT_USER_SMALL_NO_OPTIONAL_DATA
プライバシーに依存するデータがミニダンプに含まれないようにします。 現在、このフラグは、次のフラグが設定されているために追加されたミニダンプ データから除外されます。
DEBUG_FORMAT_USER_SMALL_PROCESS_THREAD_DATA、
DEBUG_FORMAT_USER_SMALL_FULL_MEMORY、
DEBUG_FORMAT_USER_SMALL_INDIRECT_MEMORY、
DEBUG_FORMAT_USER_SMALL_PRIVATE_READ_WRITE_MEMORY。
DEBUG_FORMAT_USER_SMALL_FULL_MEMORY_INFO すべての基本的なメモリ情報を追加します。 これは QueryVirtual メソッドによって返される情報です。 有効なメモリだけでなく、すべてのメモリの情報が含まれています。これにより、デバッガーはミニダンプから完全な仮想メモリ レイアウトを再構築できます。
DEBUG_FORMAT_USER_SMALL_THREAD_INFO 実行時間、開始時刻、終了時刻、開始アドレス、終了状態など、スレッド情報を追加します。
DEBUG_FORMAT_USER_SMALL_CODE_SEGMENTS 実行可能イメージを使用して、すべてのコード セグメントを追加します。
 

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

要件

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

こちらもご覧ください

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

IDebugClient2

IDebugClient3

IDebugClient4

IDebugClient5

WriteDumpFileWide