使用指定的 XML 创建数据收集器。
语法
HRESULT CreateDataCollectorFromXml(
[in] BSTR bstrXml,
[out] IValueMap **pValidation,
[out] IDataCollector **pCollector
);
参数
[in] bstrXml
包含要创建的数据收集器的 XML 的字符串。 有关指定 XML 字符串的详细信息，请参阅要创建的数据收集器的“备注”部分。
[out] pValidation
一个 IValueMap 接口，用于检索其值无效的每个属性的验证错误。 如果没有错误， 则 IValueMap：：Count 属性为零。
[out] pCollector
新创建的数据收集器的 IDataCollector 接口。 若要获取请求的实际数据收集器接口，请调用 QueryInterface 方法。
返回值
如果成功，则返回S_OK。
注解
如果 XML 语法有效，则此 API 将返回S_OK，即使一个或多个属性无效也是如此。 设置其值有效的那些属性。 值无效的那些属性设置为其默认值。
若要确定发生的错误，请检索每个错误的 IValueMapItem 接口。 IValueMapItem：：Key 属性包含错误元素的 XPath，例如 /AlertDataCollector/TaskArguments。 IValueMapItem：：Value 属性包含与错误关联的 HRESULT，IValueMapItem：:D escription 属性包含与错误关联的消息文本。
通常，发生的任何错误都将是以下 HRESULT 值之一。
| 错误 | 说明 |
|---|---|
| PLA_S_PROPERTY_IGNORED | PLA 忽略属性元素，因为数据收集器不包含指定的属性。 |
| PLA_E_PROPERTY_CONFLICT | 属性与其他属性冲突，例如 LogAppend 和 LogCircular 都VARIANT_TRUE。 |
使用以下接口标识符之一来查询特定数据收集器的 IDataCollector 接口。
| 数据收集器接口 | 接口标识符 |
|---|---|
| IApiTracingDataCollector | IID_IApiTracingDataCollector |
| IAlertDataCollector | IID_IAlertDataCollector |
| IConfigurationDataCollector | IID_IConfigurationDataCollector |
| IPerformanceCounterDataCollector | IID_IPerformanceCounterDataCollector |
| ITraceDataCollector | IID_ITraceDataCollector |
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | pla.h |
| DLL | Pla.dll |