Método IWbemClassObject::GetObjectText (wbemcli.h)
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:
- Os parâmetros são resequenciados na ordem de seus valores de identificador.
- 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 |