Método IWbemClassObject::GetObjectText (wbemcli.h)
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:
- Los parámetros se vuelven a poner en cola según el orden de sus valores de identificador.
- 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 |