WheaFindNextErrorRecordSection 函式 （ntddk.h）
WheaFindNextErrorRecordSection 函式可讓呼叫者反覆檢查 WHEA 錯誤記錄區段中 錯誤記錄。 每個錯誤記錄區段都會格式化為 WHEA_ERROR_RECORD_SECTION_DESCRIPTOR 結構。
語法
NTSTATUS WheaFindNextErrorRecordSection(
[in] PWHEA_ERROR_RECORD Record,
[in, out] ULONG *Context,
[out] PWHEA_ERROR_RECORD_SECTION_DESCRIPTOR *SectionDescriptor,
[out, optional] PVOID *SectionData
);
參數
[in] Record
WHEA 錯誤記錄的指標， 格式為 WHEA_ERROR_RECORD 結構。
[in, out] Context
ULONG 變數的指標，可維護搜尋的目前狀態。
此變數必須在第一次呼叫 WheaFindNextErrorRecordSection 函式之前初始化為零。
[out] SectionDescriptor
WHEA_ERROR_RECORD_SECTION_DESCRIPTOR 指標的位址。
如果 WheaFindNextErrorRecordSection 函式會在指定的 WHEA 錯誤記錄中找到下一個WHEA_ERROR_RECORD_SECTION_DESCRIPTOR結構，則函式會將 SectionDescriptor 參數設定為指定 WHEA 錯誤記錄內的該結構位址。
[out, optional] SectionData
PVOID 指標的位址。
如果 WheaFindNextErrorRecordSection 函式在指定的 WHEA 錯誤記錄中找到下一個 WHEA_ERROR_RECORD_SECTION_DESCRIPTOR 結構，則函式會將 SectionData 參數設定為與該描述元相關聯之硬體錯誤數據的位址。
此參數是選擇性的，而且如果不需要錯誤記錄區段數據的指標，則必須設定為 NULL。
傳回值
WheaFindNextErrorRecordSection 會傳回下列其中一個 NTSTATUS 代碼：
| 傳回碼 | 描述 |
|---|---|
| STATUS_SUCCESS | 找到下一個 WHEA_ERROR_RECORD_SECTION_DESCRIPTOR 結構。 |
| STATUS_NOT_FOUND | 找不到下一個 WHEA_ERROR_RECORD_SECTION_DESCRIPTOR 結構。 |
| STATUS_INVALID_PARAMETER | Record、SectionType、 或 SectionDescriptor 參數都設定為 NULL，或透過 Record 參數參考的 WHEA_ERROR_RECORD 數據無效。 |
言論
如果 Context 參數設定為 0，WheaFindNextErrorRecordSection 會傳回 WHEA 中第一個 WHEA_ERROR_RECORD_SECTION_DESCRIPTOR 結構的指標 錯誤記錄。 WheaFindNextErrorRecordSection 也會使用透過 SectionDescriptor 參數傳回之WHEA_ERROR_RECORD_SECTION_DESCRIPTOR相關的狀態資訊來更新 Context 參數。
在後續呼叫 WheaFindNextErrorRecordSection時，函式會傳回 WHEA 錯誤記錄內的下一個WHEA_ERROR_RECORD_SECTION_DESCRIPTOR結構（如果有的話）。 如果函式找到下一個WHEA_ERROR_RECORD_SECTION_DESCRIPTOR結構，它會更新 Context 參數。 否則，函式會傳回STATUS_NOT_FOUND。
若要在指定的 WHEA 錯誤記錄中找出第一個 WHEA_ERROR_RECORD_SECTION_DESCRIPTOR，呼叫端必須在呼叫之前，將位址傳入 Context 參數中的變數設定為 0。 之後，呼叫者在透過後續 呼叫 WheaFindNextErrorRecordSection尋找下一個WHEA_ERROR_RECORD_SECTION_DESCRIPTOR時，不得修改變量的值。
此外，如果 WheaFindNextErrorRecordSection 傳回STATUS_SUCCESS，而呼叫者會將 SectionData 參數設定為 PVOID 指標變數的位址，函式會以與指定之 WHEA_ERROR_RECORD_SECTION_DESCRIPTOR 結構相關聯的硬體錯誤數據位址來更新 參數。
硬體錯誤數據的格式取決於透過 SectionDescriptor 參數所參考之 WHEA_ERROR_RECORD_SECTION_DESCRIPTOR 結構的 SectionType 成員。 例如，如果 SectionType 成員具有值PROCESSOR_GENERIC_ERROR_SECTION_GUID，硬體錯誤數據會格式化為 WHEA_PROCESSOR_GENERIC_ERROR_SECTION 結構。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 7 和更新版本的 Windows 支援。 |
| 目標平臺 | 桌面 |
| 標頭 | ntddk.h （包括 Ntddk.h） |
| IRQL | IRQL <= DISPATCH_LEVEL |