Método IWbemClassObject::GetObjectText (wbemcli.h)

  • Artículo

El método IWbemClassObject::GetObjectText devuelve una representación textual del objeto en la sintaxis MOF. Tenga en cuenta que el texto MOF devuelto no contiene toda la información sobre el objeto, sino solo suficiente información para que el compilador MOF pueda volver a crear el objeto original. Por ejemplo, no se muestran calificadores propagados ni propiedades de clase primaria.

Sintaxis

HRESULT GetObjectText(
  [in]  long lFlags,
  [out] BSTR *pstrObjectText
);

Parámetros

[in] lFlags

Normalmente 0. Si se especifica WBEM_FLAG_NO_FLAVORS , los calificadores se mostrarán sin información de propagación o sabor.

[out] pstrObjectText

Esto debe apuntar a NULL en la entrada. Este parámetro recibe de Administración de Windows un BSTR recién asignado que se inicializó con SysAllocString. Debe llamar a SysFreeString en el puntero cuando la cadena ya no sea necesaria. Este puntero apunta a una representación de sintaxis MOF del objeto cuando se devuelve desde la llamada. Dado que se trata de un parámetro out, el puntero no debe apuntar a una cadena que sea válida antes de llamar a este método, ya que el puntero no se desasignará.

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. Para obtener valores HRESULT generales, consulte Códigos de error del sistema.

Comentarios

El siguiente algoritmo se usa para reconstruir el texto de los parámetros de un método:

  1. Los parámetros se vuelven a poner en cola según el orden de sus valores de identificador.
  2. Los parámetros especificados como [in] y [out] se combinarán en un solo parámetro.

Requisitos

   
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 CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll

Consulte también

IWbemClassObject

IWbemQualifierSet

WBEM_TEXT_FLAG_TYPE