iDataCollector：：SetXml 方法 (pla.h)

設定 XML 中包含的這些屬性的屬性值。

語法

HRESULT SetXml(
  [in]  BSTR      Xml,
  [out] IValueMap **Validation
);

[in] Xml

XML，其中包含要設定的收集器屬性。如需指定 XML 字串的詳細資訊，請參閱 IDataCollector的一節。

[out] Validation

您用來擷取其值無效之每個屬性的驗證錯誤 IValueMap 介面。如果沒有錯誤， IValueMap：：Count 屬性為零。

如果方法呼叫成功，則傳回S_OK。您必須檢查值對應是否有錯誤。如果方法傳回S_OK且沒有任何驗證錯誤，則收集器已成功初始化。

如果 XML 語法有效，即使一或多個屬性無效，此 API 仍會傳回S_OK。設定其值有效的這些屬性。其值不正確屬性會設定為其預設值。

您也可以在建立資料收集器時，將 XML 傳遞至 IDataCollectorCollection：：CreateDataCollectorFromXml 屬性，以初始化收集器屬性。

如果 XML 中指定的收集器專案不符合介面的收集器型別，此方法就會失敗。

若要判斷發生的錯誤，請擷取每個錯誤的 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。