Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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:
|
| 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 |
|
| Typbibliothek |
|
| DLL |
|
| CLSID |
CLSID_SWbemObjectEx |
| IID |
IID_ISWbemObjectEx |