diagnosticdataquery.h 标头

此标头由安全和标识使用。 有关详细信息，请参阅：

• 安全和标识

diagnosticdataquery.h 包含以下编程接口：

函数

DdqCancelDiagnosticRecordOperation 取消此会话的所有未完成的诊断数据查询 API 内部查询操作。 可以从另一个线程调用，以中断长时间运行的查询 API。
DdqCloseSession 关闭诊断数据查询会话句柄。
DdqCreateSession 创建用于唯一标识诊断数据查询会话的诊断数据查询 API 会话句柄。
DdqExtractDiagnosticReport 此 API 用于检索Windows 错误报告报告，将 cab 提取到指定的目标路径。 如果错误报告不包含任何 cab，则不执行任何工作。
DdqFreeDiagnosticRecordLocaleTags 释放为HDIAGNOSTIC_EVENT_TAG_DESCRIPTION句柄引用的标记信息分配的内存。
DdqFreeDiagnosticRecordPage 释放为HDIAGNOSTIC_RECORD句柄引用的诊断记录页分配的内存。
DdqFreeDiagnosticRecordProducerCategories 释放为类别集分配的内存，以及HDIAGNOSTIC_EVENT_CATEGORY_DESCRIPTION句柄引用的类别的文本表示形式。
DdqFreeDiagnosticRecordProducers 释放为HDIAGNOSTIC_EVENT_PRODUCER_DESCRIPTION句柄引用的生成者集分配的内存。
DdqFreeDiagnosticReport 释放为HDIAGNOSTIC_REPORT_DATA句柄引用的错误报告分配的内存。
DdqGetDiagnosticDataAccessLevelAllowed 返回 API 调用方的最高可用数据访问级别。 这可以是 NoData、CurrentUserData 或 AllUserData。
DdqGetDiagnosticRecordAtIndex 提取HDIAGNOSTIC_DATA_RECORD句柄指向的资源中指定索引处的诊断数据记录信息。
DdqGetDiagnosticRecordBinaryDistribution 根据总估计上传大小提取前 N 个最杂项二进制文件的二进制名称和关联的诊断数据事件量估计总上传量（以字节为单位），其中 N 是为 topNBinaries 传入的值。
DdqGetDiagnosticRecordCategoryAtIndex 提取HDIAGNOSTIC_DATA_EVENT_CATEGORY_DESCRIPTION句柄指向的资源中指定索引处的诊断记录类别。
DdqGetDiagnosticRecordCategoryCount 提取HDIAGNOSTIC_EVENT_CATEGORY_DESCRIPTION句柄指向的资源中诊断记录类别的数量 (大小) 。
DdqGetDiagnosticRecordCount 提取HDIAGNOSTIC_DATA_RECORD句柄指向的资源中元素的数量 (大小) 。
DdqGetDiagnosticRecordLocaleTagAtIndex 提取HDIAGNOSTIC_DATA_EVENT_TAG_DESCRIPTION句柄指向的资源中指定索引处的标记说明。
DdqGetDiagnosticRecordLocaleTagCount 提取HDIAGNOSTIC_DATA_EVENT_TAG_DESCRIPTION句柄指向的资源中标记的数量 (大小) 。
DdqGetDiagnosticRecordLocaleTags 提取指定区域设置下的所有已知标记的信息，并为数据提供HDIAGNOSTIC_EVENT_TAG_DESCRIPTION句柄。 示例区域设置为“en-US”。 示例返回值是包含以下数据的DIAGNOSTIC_EVENT_TAG_DESCRIPTION资源：标记：11，名称：“设备连接和配置”和说明：“描述连接到服务和网络的设备的连接和配置的数据，包括设备标识符 (例如 IP 地址) 配置、设置和性能”。
DdqGetDiagnosticRecordPage 提取页面 (筛选记录的批处理) 。 使用 searchCriteria、pageRecordCount、offset 和 baseRowId DIAGNOSTIC_DATA_SEARCH_CRITERIA输入参数对返回的记录进行筛选。
DdqGetDiagnosticRecordPayload 提取由 rowId 指定的事件记录的有效负载文本。
DdqGetDiagnosticRecordProducerAtIndex 提取HDIAGNOSTIC_EVENT_PRODUCER_DESCRIPTION句柄指向的资源中指定索引处的生成者的说明。
DdqGetDiagnosticRecordProducerCategories 生成者和类别具有分层关系，即类别属于生成者。 此函数提取给定诊断生成者名称的类别的可用类别 ID 和文本表示形式。
DdqGetDiagnosticRecordProducerCount 提取HDIAGNOSTIC_EVENT_PRODUCER_DESCRIPTION指向的资源中生成者的数量 (大小) 。
DdqGetDiagnosticRecordProducers 提取可用于诊断数据查询会话的诊断数据生成者。
DdqGetDiagnosticRecordStats 提取筛选的事件脚本诊断数据记录统计信息。使用输入参数（DIAGNOSTIC_DATA_SEARCH_CRITERIA筛选器）对返回的统计信息进行筛选。 记录状态描述有多少条与搜索条件匹配的记录可用，并返回用于进一步查询数据的参数。 此 API 的一个用途是检查自上次查询数据以来是否发生了更改。 输出参数的更改表示事件脚本记录状态的更改。
DdqGetDiagnosticRecordSummary 提取有关诊断数据记录的常规统计信息，可按生成者筛选。
DdqGetDiagnosticRecordTagDistribution 根据指定的生成者名称提取每个隐私标记事件分布统计信息的诊断数据事件。
DdqGetDiagnosticReport 通过HDIAGNOSTIC_REPORT_DATA句柄从此电脑提取上传或排队上传的错误报告。
DdqGetDiagnosticReportAtIndex 在HDIAGNOSTIC_REPORT_DATA句柄指向的资源中的指定索引处提取错误报告及其信息。
DdqGetDiagnosticReportCount 提取HDIAGNOSTIC_REPORT_DATA句柄指向的资源中的错误报告的数量 (大小) 。
DdqGetDiagnosticReportStoreReportCount 提取存储在请求的存储中的报表的数量 (大小) 。
DdqGetSessionAccessLevel 返回当前诊断数据查询会话的数据访问级别。
DdqGetTranscriptConfiguration 获取事件脚本配置，例如最大存储大小和数据历史记录小时数。
DdqIsDiagnosticRecordSampledIn 获取事件的设备的采样状态。
DdqSetTranscriptConfiguration 设置事件脚本配置，例如最大存储大小和数据历史记录小时数。 请注意，如果未提升用户，设置配置将失败。