IDebugClient5：：WriteDumpFile 方法 （dbgeng.h）
WriteDumpFile 方法會建立使用者模式或 kernel-modecrash 傾印檔案。
語法
HRESULT WriteDumpFile(
[in] PCSTR DumpFile,
[in] ULONG Qualifier
);
參數
[in] DumpFile
指定要建立的傾印檔案名稱。 DumpFile 必須包含擴展名。 DumpFile 可以包含相對或絕對路徑;相對路徑相對於啟動調試程序的目錄。
[in] Qualifier
指定要建立的傾印文件類型。 如需可能的值，請參閱。
傳回值
這個方法也可能傳回錯誤值。 如需詳細資訊，請參閱 傳回值。
| 傳回碼 | 描述 |
|---|---|
|
方法成功。 |
言論
DEBUG_DUMP_XXX 常數會由 WriteDumpFile 、WriteDumpFile2和 WriteDumpFileWide 方法來指定要建立的損毀傾印文件類型。
可能的值包括下列專案。
| 不斷 | 描述 |
|---|---|
| DEBUG_DUMP_SMALL | 建立小型記憶體傾印（內核模式）或迷你傾印（使用者模式）。 |
| DEBUG_DUMP_DEFAULT | 建立完整 User-Mode 傾印 （使用者模式） 或核心摘要傾印 （kernel-mode）。 |
| DEBUG_DUMP_FULL |
建立完整記憶體傾印（僅限內核模式）。 |
若要指定要包含在檔案中的檔案和 --for user-mode minidumps-- 資訊的格式設定，請使用 WriteDumpFile2 或 WriteDumpFileWide。
如需損毀傾印檔案的詳細資訊，請參閱 Dump-File 目標。
此外，下列別名可用於內核模式偵錯。
| 別名 | 價值 |
|---|---|
| DEBUG_KERNEL_SMALL_DUMP | DEBUG_DUMP_SMALL |
| DEBUG_KERNEL_DUMP | DEBUG_DUMP_DEFAULT |
| DEBUG_KERNEL_FULL_DUMP | DEBUG_DUMP_FULL |
此外，下列別名可用於使用者模式偵錯。
| 別名 | 價值 |
|---|---|
| DEBUG_USER_WINDOWS_SMALL_DUMP | DEBUG_DUMP_SMALL |
| DEBUG_USER_WINDOWS_DUMP | DEBUG_DUMP_DEFAULT |
如需核心模式傾印檔案的描述，請參閱 Kernel-Mode 傾印檔案的品種。 如需使用者模式傾印檔案的描述，請參閱 User-Mode 傾印檔案的品種。
要求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 桌面 |
| 標頭 | dbgeng.h （include Dbgeng.h） |