IDataCollectorCollection：：CreateDataCollectorFromXml 方法 (pla.h)

使用指定的 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 值。

錯誤	Description
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