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 |