metodo SWbemObjectEx.GetText_

Articolo
07/14/2023

Il metodo GetText_ dell'oggetto SWbemObjectEx restituisce una rappresentazione XML di un oggetto o di un'istanza. Il file di testo viene formattato nel formato XML specificato come illustrato in WbemObjectTextFormatEnum.

Per una spiegazione di questa sintassi, vedere Document Conventions per l'API di scripting.

Sintassi

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

Parametri

iTextFormat [in]: Obbligatorio. Valore di WbemObjectTextFormatEnum che specifica il formato XML risultante.
iFlags [in, facoltativo]: Flag di operazione riservata. Il valore predefinito è 0 (zero).
objWbemNamedValueSet [in, facoltativo]: Oggetto SWbemNamedValueSet che imposta il contesto per l'operazione. Il valore predefinito è Null. Per altre informazioni sulle coppie nome/valore consentite, vedere La sezione Osservazioni di seguito.

Valore restituito

Questo metodo non ha valori restituiti.

Codici di errore

Dopo il completamento del metodo GetText_ , l'oggetto Err può contenere uno dei codici di errore nell'elenco seguente.

wbemErrFailed - 2147749889 (0x80041001): Errore non specificato.
wbemErrNotFound - 2147749890 (0x80041002): Il formato richiesto non è stato trovato.
wbemErrInvalidParameter - 2147749896 (0x80041008): Uno dei parametri della chiamata non è corretto.
wbemErrCriticalError - 2147749898 (0x8004100A): Si è verificato un errore interno, irreversibile e inaspettato. Segnalare l'errore al Servizio Supporto Tecnico Microsoft.

Commenti

Quando si costruisce SWbemNamedValueSet, sono consentite solo le coppie nome/valore seguenti.

Nome	Valore
LocalOnly	VT_BOOL Se TRUE, nel codice XML risultante sono presenti solo proprietà e metodi definiti localmente. Il valore predefinito è FALSE.
IncludeQualifiers	VT_BOOL Se TRUE, i qualificatori di classi, istanze, proprietà e metodi vengono inclusi nel codice XML risultante. Il valore predefinito è FALSE.
PathLevel	VT-I4 Il valore predefinito è 0 (zero). I valori possibili sono: 0: viene creato un <elemento CLASS> o <INSTANCE> a seconda che l'oggetto sia una classe o un'istanza. 1: VALORE <. Viene generato l'elemento NAMEDOBJECT> . 2: VALORE >. Viene generato l'elemento OBJECTWITHLOCALPATH> . 3: VALORE >. Viene generato l'elemento OBJECTWITHPATH> .
ExcludeSystemProperties	VT-BOOL Se TRUE, le proprietà di sistema, ad esempio __NAMESPACE, vengono escluse dall'output.
IncludeClassOrigin	VT_BOOL Se TRUE, l'attributo di origine della classe viene impostato sugli >elementi PROPERTY> e >METHOD> . Il valore predefinito è FALSE.

Per altre informazioni sulla creazione di un oggetto SWbemNamedValueSet, vedere SWbemNamedValueSet.Add.

Esempio

Lo script seguente illustra come ottenere una rappresentazione XML della definizione della classe Win32_Bios . Specificando una particolare istanza di Win32_Bios, è possibile ottenere i dati di tale oggetto in XML.

' 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

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Intestazione	Wbemdisp.h
Libreria dei tipi	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemObjectEx
IID	IID_ISWbemObjectEx

Condividi tramite