IWbemObjectTextSrc::GetText-Methode (wbemcli.h)

Die IWbemObjectTextSrc::GetText-Methode erstellt eine Textdarstellung eines IWbemClassObject-Objekts . beispielsweise eine XML-Darstellung.

Syntax

HRESULT GetText(
  long             lFlags,
  IWbemClassObject *pObj,
  ULONG            uObjTextFormat,
  IWbemContext     *pCtx,
  BSTR             *strText
);

Parameter

lFlags

Reserviert. Muss 0L sein.

pObj

Verweis auf das Objekt, das im Textformat dargestellt werden soll. Dieser Parameter darf nicht NULL sein.

uObjTextFormat

Definition des Textformats, das zur Darstellung des Objekts verwendet wird. Weitere Informationen zu gültigen Werten für diesen Parameter finden Sie unter Hinweise.

WMI_OBJ_TEXT_CIM_DTD_2_0 (1 (0x1))

Verwenden Sie die DTD, die CIM DTD Version 2.0 entspricht.

WMI_OBJ_TEXT_WMI_DTD_2_0 (2 (0x2))

Verwenden Sie die WMI-DTD, die CIM DTD Version 2.0 entspricht. Die Verwendung dieses Werts ermöglicht WMI-spezifische Erweiterungen, z. B. eingebettete Objekte oder Bereich.

WMI_OBJ_TEXT_WMI_EXT1 (3 (0x3))

Für die zukünftige Verwendung reserviert.

WMI_OBJ_TEXT_WMI_EXT2 (4 (0x4))

Für die zukünftige Verwendung reserviert.

WMI_OBJ_TEXT_WMI_EXT3 (5 (0x5))

Für die zukünftige Verwendung reserviert.

WMI_OBJ_TEXT_WMI_EXT4 (6 (0x6))

Für die zukünftige Verwendung reserviert.

WMI_OBJ_TEXT_WMI_EXT5 (7 (0x7))

Für die zukünftige Verwendung reserviert.

WMI_OBJ_TEXT_WMI_EXT6 (8 (0x8))

Für die zukünftige Verwendung reserviert.

WMI_OBJ_TEXT_WMI_EXT7 (9 (0x9))

Für die zukünftige Verwendung reserviert.

WMI_OBJ_TEXT_WMI_EXT8 (10 (0xA))

Für die zukünftige Verwendung reserviert.

WMI_OBJ_TEXT_WMI_EXT9 (11 (0xB))

Für die zukünftige Verwendung reserviert.

WMI_OBJ_TEXT_WMI_EXT10 (12 (0xC))

Für die zukünftige Verwendung reserviert.

WMI_OBJ_TEXT_LAST (13 (0xD))

Für die zukünftige Verwendung reserviert.

pCtx

Optional. Kontextobjekt für den Vorgang. Das Kontextobjekt kann verwendet werden, um anzugeben, ob bestimmte Teile des Objekts im Text dargestellt werden. beispielsweise, ob Qualifizierer in die Textdarstellung eingeschlossen werden sollen. Das Kontextobjekt verwendet die folgenden optionalen Werte.

LocalOnly (VT_BOOL)

Bei TRUE sind nur lokal definierte Eigenschaften und Methoden im resultierenden XML-Code vorhanden. Der Standardwert ist FALSE.

IncludeQualifiers (VT_BOOL)

True gibt an, dass die Qualifizierer von Klassen, Instanzen, Eigenschaften und Methoden in der Ausgabe enthalten sind. Der Standardwert lautet FALSE.

PathLevel (VT_I4)

Der Standardwert ist 0 (null).

Mögliche Werte:

• 0

  Je nachdem, ob das Objekt eine Klasse oder eine instance ist, wird ein CLASS- oder INSTANCE-Element erstellt.

• 1

  Ein WERT. DAS NAMEDOBJECT-Element wird generiert.

• 2

  Ein WERT. DAS OBJECTWITHLOCALPATH-Element wird generiert.

• 3

  Ein WERT. DAS OBJECTWITHPATH-Element wird generiert.

ExcludeSystemProperties (VT_BOOL)

Bei TRUE fehlen Systemeigenschaften wie __NAMESPACE in der Ausgabe. Der Standardwert lautet FALSE.

IncludeClassOrigin (VT_BOOL)

Bei TRUE wird das Klassenursprungsattribut für PROPERTY - und METHOD-Elemente festgelegt. Der Standardwert lautet FALSE.

strText

Textdarstellung des Objekts. Der Benutzer muss die Zeichenfolge mithilfe von SysFreeString freigeben, wenn er mit strText fertig ist.

Rückgabewert

Diese Methode gibt ein HRESULT zurück, das den Status des Methodenaufrufs angibt. In der folgenden Liste ist der in einem HRESULT enthaltene Wert aufgeführt.

Hinweise

Weitere Informationen finden Sie unter Darstellen von Objekten in XML.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	wbemcli.h (include Wbemidl.h)
Bibliothek	Wbemuuid.lib
DLL	Fastprox.dll