werRegisterFile 函式 (werapi.h)
Windows 錯誤報告 ( WER) 建立錯誤報告時,註冊要收集的檔案。
語法
HRESULT WerRegisterFile(
[in] PCWSTR pwzFile,
[in] WER_REGISTER_FILE_TYPE regFileType,
[in] DWORD dwFlags
);
參數
[in] pwzFile
檔案的完整路徑。 此路徑的最大長度是MAX_PATH個字元。
[in] regFileType
檔案類型。 這個參數可以是 下列 WER_REGISTER_FILE_TYPE列舉類型的其中一個值。
值 | 意義 |
---|---|
WerRegFileTypeMax | |
3 | WER_REGISTER_FILE_TYPE列舉類型的最大值。 |
WerRegFileTypeOther | |
2 | 任何其他類型的檔案。 |
WerRegFileTypeUserDocument | |
1 | 應用程式在事件發生時使用的檔。 只有在 Watson 伺服器要求檔時,才會收集此檔。 |
[in] dwFlags
此參數可以是下列一或多個值。
值 | 意義 |
---|---|
WER_FILE_ANONYMOUS_DATA | 檔案不包含可用來識別或連絡用戶的個人資訊。 |
WER_FILE_DELETE_WHEN_DONE | 將檔案新增至報表之後,自動刪除該檔案。 |
傳回值
此函式會在成功或失敗時傳回錯誤碼 S_OK ,包括下列錯誤碼。
傳回碼 | Description |
---|---|
WER_E_INVALID_STATE | 進程狀態無效。 例如,此程式處於應用程式恢復模式。 |
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) | 已註冊的記憶體區塊和檔案數目超過限制。 |
備註
只有在伺服器要求其他數據時,才會將已註冊的檔案新增至報表。
針對當機和非回應,操作系統會自動提供錯誤報告 (您不需要在應用程式中提供任何錯誤報告碼) 。 如果您使用這個函式來註冊檔案,除了操作系統已經收集的檔案之外,操作系統還會將檔案新增至當機或非回應時所建立的錯誤報告, (此檔案已收集) 。
針對泛型事件報告,應用程式必須改用 WerReportAddFile 函式。 或者,使用 WER_SUBMIT_ADD_REGISTERED_DATA 旗標呼叫 WerReportSubmit 函式,將會包含 WerRegisterFile 函式新增的檔案。
若要從清單中移除檔案,請呼叫 WerUnregisterFile 函式。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | werapi.h |
程式庫 | Kernel32.lib |
DLL | Kernel32.dll |