IDebugClient5::WriteDumpFileWide 方法 (dbgeng.h)
WriteDumpFileWide 方法會建立使用者模式或 kernel-modecrash 傾印檔案。
語法
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
指定旗標,決定傾印檔案的格式,以及 --for user-mode minidumps--要包含在檔案中的資訊。 如需詳細資訊,請參閱 DEBUG_FORMAT_XXX。
[in, optional] Comment
指定要包含在損毀傾印檔案中的批註字串。 載入傾印檔案時,這個字串會顯示在調試程式控制台中。
傳回值
這個方法也可能傳回錯誤值。 如需詳細資訊,請參閱 傳回值。
傳回碼 | 描述 |
---|---|
|
方法成功。 |
言論
如需損毀傾印檔案的詳細資訊,請參閱 Dump-File 目標。
要求
要求 | 價值 |
---|---|
目標平臺 | 桌面 |
標頭 | dbgeng.h (include Dbgeng.h) |