IDataCollectorSet：：SetXml 方法 (pla.h)

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

語法

HRESULT SetXml(
  [in]  BSTR      xml,
  [out] IValueMap **validation
);

[in] xml

包含要設定之屬性的 XML。如需指定 XML 字串的詳細資訊，請參閱 IDataCollectorSet 的一節。

[out] validation

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

如果方法呼叫成功，則傳回S_OK。您必須檢查值對應是否有錯誤。如果方法傳回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。