IDataCollectorCollection::CreateDataCollectorFromXml-Methode (pla.h)

  • Artikel

Erstellt einen Datensammler unter Verwendung des angegebenen XML-Codes.

Syntax

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

Parameter

[in] bstrXml

Eine Zeichenfolge, die den XML-Code des zu erstellenden Datensammlers enthält. Ausführliche Informationen zum Angeben der XML-Zeichenfolge finden Sie im Abschnitt Hinweise des Datensammlers, den Sie erstellen möchten.

[out] pValidation

Eine IValueMap-Schnittstelle , die Sie zum Abrufen des Validierungsfehlers jeder Eigenschaft verwenden, deren Wert ungültig ist. Die IValueMap::Count-Eigenschaft ist null, wenn keine Fehler aufgetreten sind.

[out] pCollector

Eine IDataCollector-Schnittstelle des neu erstellten Datensammlers. Rufen Sie die QueryInterface-Methode auf, um die tatsächlich angeforderte Datensammlerschnittstelle abzurufen.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK zurück.

Hinweise

Wenn die XML-Syntax gültig ist, gibt diese API S_OK zurück, auch wenn mindestens eine Eigenschaft ungültig ist. Die Eigenschaften, deren Werte gültig sind, werden festgelegt. Eigenschaften, deren Werte ungültig sind, werden auf ihren Standardwert festgelegt.

Um die aufgetretenen Fehler zu ermitteln, rufen Sie die IValueMapItem-Schnittstelle für jeden Fehler ab. Die IValueMapItem::Key-Eigenschaft enthält den XPath des Elements in Error, z. B. /AlertDataCollector/TaskArguments. Die IValueMapItem::Value-Eigenschaft enthält das HRESULT, das dem Fehler zugeordnet ist, und die IValueMapItem::D escription-Eigenschaft enthält den dem Fehler zugeordneten Meldungstext.

In der Regel handelt es sich bei fehlern, die auftreten, um einen der folgenden HRESULT-Werte.

Fehler BESCHREIBUNG
PLA_S_PROPERTY_IGNORED PLA hat das Eigenschaftselement ignoriert, da der Datensammler die angegebene Eigenschaft nicht enthält.
PLA_E_PROPERTY_CONFLICT Die -Eigenschaft ist mit einer anderen Eigenschaft in Konflikt, z. B. sind sowohl LogAppend als auch LogCircular VARIANT_TRUE.
 

Verwenden Sie einen der folgenden Schnittstellenbezeichner, um die IDataCollector-Schnittstelle für den spezifischen Datensammler abzufragen.

Datensammlerschnittstelle Schnittstellen-ID
IApiTracingDataCollector IID_IApiTracingDataCollector
IAlertDataCollector IID_IAlertDataCollector
IConfigurationDataCollector IID_IConfigurationDataCollector
IPerformanceCounterDataCollector IID_IPerformanceCounterDataCollector
ITraceDataCollector IID_ITraceDataCollector

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile pla.h
DLL Pla.dll

Weitere Informationen

IDataCollectorCollection

IDataCollectorCollection::CreateDataCollector