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

  • Artigo

O método IWbemClassObject::GetObjectText retorna uma renderização textual do objeto na sintaxe MOF. Observe que o texto MOF retornado não contém todas as informações sobre o objeto, mas apenas informações suficientes para que o compilador MOF possa recriar o objeto original. Por exemplo, nenhum qualificador propagado ou propriedades de classe pai são exibidos.

Sintaxe

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

Parâmetros

[in] lFlags

Normalmente 0. Se WBEM_FLAG_NO_FLAVORS for especificado, os qualificadores serão apresentados sem informações de propagação ou sabor.

[out] pstrObjectText

Isso deve apontar para NULL na entrada. Esse parâmetro recebe do Gerenciamento do Windows um BSTR recém-alocado que foi inicializado com SysAllocString. Você deve chamar SysFreeString no ponteiro quando a cadeia de caracteres não for mais necessária. Esse ponteiro aponta para uma renderização de sintaxe MOF do objeto no retorno da chamada. Como esse é um parâmetro out, o ponteiro não deve apontar para uma cadeia de caracteres válida antes que esse método seja chamado, pois o ponteiro não será desalocado.

Retornar valor

Esse método retorna um HRESULT que indica o status da chamada de método. A lista a seguir lista o valor contido em um HRESULT. Para obter valores gerais de HRESULT , consulte Códigos de erro do sistema.

Comentários

O seguinte algoritmo é usado para reconstruir o texto dos parâmetros de um método:

  1. Os parâmetros são resequenciados na ordem de seus valores de identificador.
  2. Os parâmetros especificados como [in] e [out] serão combinados em um único parâmetro.

Requisitos

   
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho wbemcli.h (include Wbemidl.h)
Biblioteca WbemUuid.lib
DLL CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll

Confira também

IWbemClassObject

IWbemQualifierSet

WBEM_TEXT_FLAG_TYPE