Compartir a través de


Método SWbemObjectEx.GetText_

El método GetText_ del objeto SWbemObjectEx devuelve una representación XML de un objeto o instancia. El archivo de texto tiene el formato XML especificado como se muestra en WbemObjectTextFormatEnum.

Para obtener una explicación de esta sintaxis, vea Convenciones de documentación para la API de scripting.

Sintaxis

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

Parámetros

iTextFormat [in]

Necesario. Valor de WbemObjectTextFormatEnum que especifica el formato XML resultante.

iFlags [entrada, opcional]

Marcas de operación reservadas. El valor predeterminado es 0 (cero).

objWbemNamedValueSet [entrada, opcional]

Objeto SWbemNamedValueSet que establece el contexto de la operación. El valor predeterminado es null. Para obtener más información sobre los pares de nombre y valor permitidos, vea Los comentarios a continuación.

Valor devuelto

Este método no tiene valores devueltos.

Códigos de error

Después de completar el método GetText_, el objeto Err puede contener uno de los códigos de error de la siguiente lista.

wbemErrFailed - 2147749889 (0x80041001)

Error no especificado.

wbemErrNotFound: 2147749890 (0x80041002)

No se encontró el formato solicitado.

wbemErrInvalidParameter - 2147749896 (0x80041008)

Uno de los parámetros de la llamada no es correcto.

wbemErrCriticalError - 2147749898 (0x8004100A)

Se produjo un error interno, grave e inesperado. Comunique este error al Servicio de soporte técnico de Microsoft.

Comentarios

Al construir SWbemNamedValueSet, solo se permiten los siguientes pares nombre-valor.

Nombre Value
LocalOnly VT_BOOL
Si es TRUE, solo las propiedades y los métodos definidos localmente están presentes en el XML resultante. El valor predeterminado es FALSE.
IncludeQualifiers VT_BOOL
Si es TRUE, los calificadores de clases, instancias, propiedades y métodos se incluyen en el XML resultante. El valor predeterminado es FALSE.
PathLevel VT-I4
El valor predeterminado es 0 (cero). Los valores posibles son:
  • 0: Se crea un <elemento CLASS> o <INSTANCE> en función de si el objeto es una clase o instancia.
  • 1: UN <VALOR. Se genera el elemento NAMEDOBJECT> .
  • 2: UN >VALOR. Se genera el elemento OBJECTWITHLOCALPATH> .
  • 3: UN >VALOR. Se genera el elemento OBJECTWITHPATH> .
ExcludeSystemProperties VT-BOOL
Si es TRUE, las propiedades del sistema, como __NAMESPACE, se excluyen de la salida.
IncludeClassOrigin VT_BOOL
Si es TRUE, el atributo de origen de clase se establece en los >elementos PROPERTY> y >METHOD> . El valor predeterminado es FALSE.

Para obtener más información sobre cómo crear un SWbemNamedValueSet, vea SWbemNamedValueSet.Add.

Ejemplos

El siguiente script muestra cómo obtener una representación XML de la definición de clase Win32_Bios. Al especificar una instancia determinada de Win32_Bios, puede obtener los datos de ese objeto en 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

Requisitos

Requisito Value
Cliente mínimo compatible
Windows Vista
Servidor mínimo compatible
Windows Server 2008
Encabezado
Wbemdisp.h
Biblioteca de tipos
Wbemdisp.tlb
Archivo DLL
Wbemdisp.dll
CLSID
CLSID_SWbemObjectEx
IID
IID_ISWbemObjectEx