IDataCollectorCollection ::CreateDataCollectorFromXml, méthode (pla.h)

  • Article

Crée un collecteur de données à l’aide du code XML spécifié.

Syntaxe

HRESULT CreateDataCollectorFromXml(
  [in]  BSTR           bstrXml,
  [out] IValueMap      **pValidation,
  [out] IDataCollector **pCollector
);

Paramètres

[in] bstrXml

Chaîne qui contient le XML du collecteur de données à créer. Pour plus d’informations sur la spécification de la chaîne XML, consultez la section Remarques du collecteur de données que vous souhaitez créer.

[out] pValidation

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.

[out] pCollector

Interface IDataCollector du collecteur de données nouvellement créé. Pour obtenir l’interface réelle du collecteur de données demandée, appelez la méthode QueryInterface .

Valeur retournée

Retourne S_OK en cas de réussite.

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.
 

Utilisez l’un des identificateurs d’interface suivants pour interroger l’interface IDataCollector pour le collecteur de données spécifique.

Interface du collecteur de données Identificateur d’interface
IApiTracingDataCollector IID_IApiTracingDataCollector
IAlertDataCollector IID_IAlertDataCollector
IConfigurationDataCollector IID_IConfigurationDataCollector
IPerformanceCounterDataCollector IID_IPerformanceCounterDataCollector
ITraceDataCollector IID_ITraceDataCollector

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

Voir aussi

IDataCollectorCollection

IDataCollectorCollection ::CreateDataCollector