Méthode IDataCollector::SetXml (pla.h)

Définit les valeurs de propriété de ces propriétés incluses dans le code XML.

Syntaxe

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

Paramètres

[in] Xml

XML qui contient les propriétés du collecteur à définir. Pour plus d’informations sur la spécification de la chaîne XML, consultez la section Remarques de IDataCollector.

[out] Validation

Interface IValueMap que vous utilisez pour récupérer l’erreur de validation de chaque propriété dont la valeur n’est pas valide. La propriété IValueMap::Count est égale à zéro s’il n’y a pas eu d’erreurs.

Valeur retournée

Retourne S_OK si l’appel de méthode a réussi. Vous devez case activée le mappage de valeurs pour les erreurs. Si la méthode retourne S_OK et qu’il n’y a pas d’erreurs de validation, le collecteur a été initialisé avec succès.

Notes

Si la syntaxe XML est valide, cette API retourne S_OK, même si une ou plusieurs propriétés ne sont pas valides. Les propriétés dont les valeurs sont valides sont définies. Les propriétés dont les valeurs ne sont pas valides sont définies sur leur valeur par défaut.

Vous pouvez également initialiser les propriétés du collecteur en transmettant le code XML à la propriété IDataCollectorCollection::CreateDataCollectorFromXml lorsque vous créez le collecteur de données.

La méthode échoue si l’élément collecteur spécifié dans le code XML ne correspond pas au type de collecteur de l’interface.

Pour déterminer les erreurs qui se sont produites, récupérez l’interface IValueMapItem pour chaque erreur. La propriété IValueMapItem::Key contient le XPath de l’élément en erreur (par exemple, /AlertDataCollector/TaskArguments), la propriété IValueMapItem::Value contient le HRESULT associé à l’erreur et la propriété IValueMapItem::D escription contient le texte du message associé à l’erreur.

En règle générale, toutes les erreurs qui se produisent sont l’une des valeurs HRESULT suivantes.

Error	Description
PLA_S_PROPERTY_IGNORED	PLA a ignoré l’élément property, car le collecteur de données ne contient pas la propriété spécifiée.
PLA_E_PROPERTY_CONFLICT	La propriété est en conflit avec une autre propriété, par exemple, LogAppend et LogCircular sont VARIANT_TRUE.

Spécifications

Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	pla.h
DLL	Pla.dll

Voir aussi

IDataCollector

IDataCollector::Xml

IDataCollectorSet::SetXml