metodo SWbemObjectEx.GetText_

  • Articolo

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