SWbemObjectEx.GetText_-Methode

Artikel
07/14/2023

Die GetText_-Methode des SWbemObjectEx-Objekts gibt eine XML-Darstellung eines Objekts oder einer Instanz zurück. Die Textdatei wird in dem XML-Format formatiert, das in WbemObjectTextFormatEnum angegeben ist.

Eine Erläuterung dieser Syntax finden Sie unter Dokumentkonventionen für die Skripterstellungs-API.

Syntax

strObj = .GetText_( _
  ByVal iTextFormat, _
  [ ByVal iFlags ], _
  [ ByVal objWbemNamedValueSet ] _
)

Parameter

iTextFormat [in]: Erforderlich. Ein Wert aus WbemObjectTextFormatEnum, der das resultierende XML-Format angibt.
iFlags [in, optional]: Reservierte Vorgangsflags. Der Standardwert ist 0 (null).
objWbemNamedValueSet [in, optional]: Ein SWbemNamedValueSet-Objekt, das den Kontext für den Vorgang festlegt. Der Standardwert ist NULL. Weitere Informationen zu den zulässigen Name-Wert-Paaren finden Sie in den Hinweisen weiter unten.

Rückgabewert

Diese Methode verfügt über keine Rückgabewerte.

Fehlercodes

Nach Abschluss der GetText_-Methode enthält das Err-Objekt möglicherweise einen der Fehlercodes aus der folgenden Liste.

wbemErrFailed – 2147749889 (0x80041001): Unbekannter Fehler.
wbemErrNotFound – 2147749890 (0x80041002): Das angeforderte Format wurde nicht gefunden.
wbemErrInvalidParameter – 2147749896 (0x80041008): Einer der Parameter für den Aufruf ist nicht korrekt.
wbemErrCriticalError – 2147749898 (0x8004100A): Ein interner, schwerwiegender und unerwarteter Fehler ist aufgetreten. Melden Sie diesen Fehler dem technischen Support von Microsoft.

Bemerkungen

Beim Erstellen Ihres SWbemNamedValueSet sind nur die folgenden Name-Wert-Paare zulässig.

Name	Wert
LocalOnly	VT_BOOL Bei TRUE sind nur lokal definierte Eigenschaften und Methoden im resultierenden XML-Code vorhanden. Der Standardwert ist FALSE.
IncludeQualifiers	VT_BOOL Bei TRUE sind Qualifizierer von Klassen, Instanzen, Eigenschaften und Methoden im resultierenden XML-Code enthalten. Der Standardwert ist 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 werden Systemeigenschaften wie __NAMESPACE von der Ausgabe ausgeschlossen.
IncludeClassOrigin	VT_BOOL Wenn TRUE, wird das Attribut des Klassenursprungs für die >ELEMENTE PROPERTY> und >METHOD> festgelegt. Der Standardwert lautet FALSE.

Weitere Informationen zum Erstellen eines SWbemNamedValueSet finden Sie unter SWbemNamedValueSet.Add.

Beispiele

Das folgende Skript zeigt, wie Sie eine XML-Darstellung der Win32_Bios-Klassendefinition abrufen. Durch Angeben einer bestimmten Instanz von Win32_Bios können Sie die Daten dieses Objekts in XML abrufen.

' Connect to the default namespace (root\cimv2) with the default
' impersonation level ("impersonate") and obtain a Win32_Bios class
' object.
Set obj = GetObject("winmgmts:win32_bios")

' Use the value for the desired XML CIM DTD format. 
XMLDtd = 1
Text = obj.GetText_(XMLDtd)
wscript.echo Text

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Header	Wbemdisp.h
Typbibliothek	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemObjectEx
IID	IID_ISWbemObjectEx

Freigeben über