Compartir a través de


Método IWbemObjectTextSrc::GetText (wbemcli.h)

El método IWbemObjectTextSrc::GetText crea una representación textual de un objeto IWbemClassObject ; por ejemplo, una representación XML.

Sintaxis

HRESULT GetText(
  long             lFlags,
  IWbemClassObject *pObj,
  ULONG            uObjTextFormat,
  IWbemContext     *pCtx,
  BSTR             *strText
);

Parámetros

lFlags

Reservado. Debe ser 0L.

pObj

Referencia al objeto que se va a representar en formato de texto. Este parámetro no puede ser NULL.

uObjTextFormat

Definición del formato de texto utilizado para representar el objeto. Para obtener más información sobre los valores válidos para este parámetro, vea Comentarios.

WMI_OBJ_TEXT_CIM_DTD_2_0 (1 (0x1))

Use el DTD que corresponde a LA VERSIÓN 2.0 de CIM DTD.

WMI_OBJ_TEXT_WMI_DTD_2_0 (2 (0x2))

Use el DTD de WMI que corresponde a la versión 2.0 de CIM DTD. El uso de este valor habilita extensiones específicas de WMI, como objetos incrustados o ámbito.

WMI_OBJ_TEXT_WMI_EXT1 (3 (0x3))

Reservado para uso futuro.

WMI_OBJ_TEXT_WMI_EXT2 (4 (0x4))

Reservado para uso futuro.

WMI_OBJ_TEXT_WMI_EXT3 (5 (0x5))

Reservado para uso futuro.

WMI_OBJ_TEXT_WMI_EXT4 (6 (0x6))

Reservado para uso futuro.

WMI_OBJ_TEXT_WMI_EXT5 (7 (0x7))

Reservado para uso futuro.

WMI_OBJ_TEXT_WMI_EXT6 (8 (0x8))

Reservado para uso futuro.

WMI_OBJ_TEXT_WMI_EXT7 (9 (0x9))

Reservado para uso futuro.

WMI_OBJ_TEXT_WMI_EXT8 (10 (0xA))

Reservado para uso futuro.

WMI_OBJ_TEXT_WMI_EXT9 (11 (0xB))

Reservado para uso futuro.

WMI_OBJ_TEXT_WMI_EXT10 (12 (0xC))

Reservado para uso futuro.

WMI_OBJ_TEXT_LAST (13 (0xD))

Reservado para uso futuro.

pCtx

Opcional. Objeto de contexto para la operación. El objeto de contexto se puede utilizar para especificar si determinadas partes del objeto se representan en texto; por ejemplo, si se deben incluir calificadores en la representación textual. El objeto de contexto toma los siguientes valores opcionales.

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 la salida. El valor predeterminado es FALSE.

PathLevel (VT_I4)

El valor predeterminado es cero (0).

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

    VALOR . Se genera el elemento NAMEDOBJECT.

  • 2

    VALOR. Se genera el elemento OBJECTWITHLOCALPATH .

  • 3

    VALOR . Se genera el elemento OBJECTWITHPATH.

ExcludeSystemProperties (VT_BOOL)

Si es TRUE, las propiedades del sistema, como __NAMESPACE, están ausentes en la salida. El valor predeterminado es FALSE.

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.

strText

Representación textual del objeto. El usuario debe liberar la cadena mediante SysFreeString cuando termine con strText.

Valor devuelto

Este método devuelve un valor HRESULT que indica el estado de la llamada al método. En la lista siguiente se muestra el valor contenido en un HRESULT.

Comentarios

Para obtener más información, vea Representar objetos en XML.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista
Servidor mínimo compatible Windows Server 2008
Plataforma de destino Windows
Encabezado wbemcli.h (include Wbemidl.h)
Library Wbemuuid.lib
Archivo DLL Fastprox.dll