IDataCollectorSet ::SetXml, méthode (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 à définir. Pour plus d’informations sur la spécification de la chaîne XML, consultez la section Remarques de IDataCollectorSet.
[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 en l’absence 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 aucune erreur de validation, l’ensemble a été initialisé avec succès.
Remarques
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.
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.
| Erreur | Description |
|---|---|
| PLA_S_PROPERTY_IGNORED | PLA a ignoré l’élément de propriété, 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. |
Configuration requise
| Condition requise | Valeur |
|---|---|
| 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 |