Share via


IDebugClient4::WriteDumpFileWide 方法 (dbgeng.h)

WriteDumpFileWide 方法會建立使用者模式或內核模式crash 傾印檔案。

語法

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

指定要寫入損毀傾印之檔案的檔案句柄。 如果 FileHandleNULL,則會改用 FileName 中指定的檔案。

[in] Qualifier

指定要建立的傾印類型。 如需可能的值,請參閱 DEBUG_DUMP_XXX

[in] FormatFlags

指定旗標,決定傾印檔案的格式,以及要包含在檔案中的使用者模式 minidumps--what 資訊。 如需詳細資訊,請參閱 DEBUG_FORMAT_XXX

[in, optional] Comment

指定要包含在損毀傾印檔案中的批註字串。 載入傾印檔案時,調試程式主控台會顯示此字串。

傳回值

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

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

備註

如需損毀傾印檔案的詳細資訊,請參閱 傾印檔案目標

規格需求

需求
目標平台 桌面
標頭 dbgeng.h (包含 Dbgeng.h)

另請參閱

.dump (建立傾印檔案)

IDebugClient4

IDebugClient5

WriteDumpFile2