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。 |
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | pla.h |
Dll | Pla.dll |