Compartilhar via

Função GetObjectText

  • Artigo

Retorna uma renderização textual do objeto na sintaxe do Managed Object Format (MOF).

Observação

Esta API é somente para uso interno. Ela não é destinada ao uso do código do desenvolvedor.

Sintaxe

HRESULT GetObjectText (
   [in] int                vFunc,
   [in] IWbemClassObject*   ptr,
   [in] LONG                lFlags,
   [out] BSTR*              pstrObjectText
);

Parâmetros

vFunc
[in] Esse parâmetro não está em uso.

ptr
[in] Um ponteiro para uma instância IWbemClassObject.

lFlags
[in] Normalmente 0. Se WBEM_FLAG_NO_FLAVORS (ou 0x1) for especificado, os qualificadores serão incluídos sem informações de propagação ou variação.

pstrObjectText [out] Um ponteiro para null uma entrada. No retorno, um recém-alocado BSTR que contém uma renderização de sintaxe MOF do objeto.

Valor retornado

Os seguintes valores retornados por essa função são definidos no arquivo de cabeçalho WbemCli.h, ou você pode defini-los como constantes em seu código:

Constante Valor Descrição
WBEM_E_FAILED 0x80041001 Houve uma falha geral.
WBEM_E_INVALID_PARAMETER 0x80041008 Um parâmetro não é válido.
WBEM_E_OUT_OF_MEMORY 0x80041006 Não há memória disponível suficiente para concluir a operação.
WBEM_S_NO_ERROR 0 A chamada de função foi bem-sucedida.

Comentários

Esta função encapsula uma chamada para o método IWbemClassObject::GetObjectText.

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 estão incluídos.

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. Parâmetros que são especificados como [in] e [out] são combinados em um único parâmetro.

pstrObjectText deve ser um ponteiro para um null quando a função é chamada; ele não deve apontar para uma string que seja válida antes da chamada do método, porque o ponteiro não será desalocado.

Requisitos

Plataformas: confira Requisitos do sistema.

Header: WMINet_Utils.idl

Versões do .NET Framework: Disponível desde 4.7.2

Confira também