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