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 |