WerReportAddFile 函式 (werapi.h)
將檔案新增至指定的 Windows 錯誤報告 (WER) 報表。
語法
HRESULT WerReportAddFile(
[in] HREPORT hReportHandle,
[in] PCWSTR pwzPath,
[in] WER_FILE_TYPE repFileType,
[in] DWORD dwFileFlags
);
參數
[in] hReportHandle
報表的句柄。 WerReportCreate 函式會傳回此句柄。
[in] pwzPath
Unicode 字串的指標，其中包含要加入之檔案的完整路徑。 此路徑可以使用環境變數。 此路徑的最大長度是MAX_PATH個字元。
[in] repFileType
檔案類型。 此參數可以是 WER_FILE_TYPE 列舉型別的下列其中一個值。
| 值 | 意義 |
|---|---|
| WerFileTypeHeapdump | 擴充的迷你傾印，包含其他數據，例如進程記憶體。 |
| WerFileTypeMicrodump | 僅包含堆疊追蹤的有限迷你傾印。 |
| WerFileTypeMinidump | 迷你傾印檔案。 |
| WerFileTypeOther | 任何其他類型的檔案。 此檔案一律會新增至 cab (，但只有在伺服器要求 cab) 時。 |
| WerFileTypeUserDocument | 應用程式在事件發生時所使用的檔。 只有在伺服器要求這種類型的檔時，才會新增檔。 |
[in] dwFileFlags
此參數可以是下列一或多個值。
| 值 | 意義 |
|---|---|
| WER_FILE_ANONYMOUS_DATA | 檔案不包含可用來識別或連絡用戶的個人資訊。 |
| WER_FILE_DELETE_WHEN_DONE | 在提交報表之後自動刪除檔案。 |
傳回值
此函式會在成功時傳回 S_OK ，或在失敗時傳回錯誤碼，包括下列錯誤碼。
| 傳回碼 | Description |
|---|---|
| HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) | 指定的檔案不存在。 |
| HRESULT_FROM_WIN32 (ERROR_NOT_SUPPORTED) | 指定的檔案是使用者檔，儲存在加密的檔案系統上;不支援這個組合。 |
備註
雖然此函式也可以用來使用特定) 旗標將記憶體轉儲新增至錯誤報告 (，但用來新增記憶體轉儲的慣用函式是 WerReportAddDump。 只有在您想要自行收集傾印，然後將它新增至報表時，才應該使用此函式。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | werapi.h |
| 程式庫 | Wer.lib |
| Dll | Wer.dll |