IDebugClient：：WriteDumpFile 方法 (dbgeng.h)

WriteDumpFile 方法會建立使用者模式或內核模式加密傾印檔案。

語法

HRESULT WriteDumpFile(
  [in] PCSTR DumpFile,
  [in] ULONG Qualifier
);

參數

[in] DumpFile

指定要建立的傾印檔名。 DumpFile 必須包含擴展名。 DumpFile 可以包含相對或絕對路徑;相對路徑相對於啟動調試程序的目錄。

[in] Qualifier

指定要建立的傾印文件類型。 如需可能的值，請參閱。

傳回值

這個方法也可能傳回錯誤值。 如需詳細資訊，請參閱 傳回值 。

傳回碼	描述
S_OK	此方法成功。

備註

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)

另請參閱

.dump (建立傾印檔案)

IDebugClient

IDebugClient2

IDebugClient3

IDebugClient4

IDebugClient5

WriteDumpFile2

WriteDumpFileWide