Метод IWbemClassObject::GetObjectText (wbemcli.h)

  • Статья

Метод IWbemClassObject::GetObjectText возвращает текстовую отрисовку объекта в синтаксисе MOF. Обратите внимание, что возвращенный MOF-текст содержит не все сведения об объекте, а только достаточно информации, чтобы компилятор MOF мог повторно создать исходный объект. Например, не отображаются распространяемые квалификаторы или свойства родительского класса.

Синтаксис

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

Параметры

[in] lFlags

Обычно 0. Если указан WBEM_FLAG_NO_FLAVORS , квалификаторы будут представлены без сведений о распространении или вкусе.

[out] pstrObjectText

Он должен указывать на NULL в записи. Этот параметр получает от управления Windows только что выделенный объект BSTR , который был инициализирован с помощью SysAllocString. Если строка больше не требуется, необходимо вызывать SysFreeString в указателе. Этот указатель указывает на синтаксическую отрисовку объекта MOF при возвращении из вызова . Так как это параметр out, указатель не должен указывать на допустимую строку перед вызовом этого метода, так как указатель не будет освобожден.

Возвращаемое значение

Этот метод возвращает HRESULT , указывающий состояние вызова метода. В следующем списке перечислены значения, содержащиеся в HRESULT. Общие значения HRESULT см. в разделе Системные коды ошибок.

Комментарии

Следующий алгоритм используется для воссоздания текста параметров метода:

  1. Параметры повторно задаются в порядке значений идентификатора.
  2. Параметры, указанные как [in] и [out], будут объединены в один параметр.

Требования

   
Минимальная версия клиента Windows Vista
Минимальная версия сервера Windows Server 2008
Целевая платформа Windows
Header wbemcli.h (включая Wbemidl.h)
Библиотека WbemUuid.lib
DLL CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll

См. также раздел

IWbemClassObject

IWbemQualifierSet

WBEM_TEXT_FLAG_TYPE