Поделиться через

Функция GetObjectText

  • Статья

Возвращает текстовую отрисовку объекта в синтаксисе MOF.

Примечание

Этот интерфейс API предназначен только для внутреннего использования. Он не предназначен для использования из кода разработчика.

Синтаксис

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

Параметры

vFunc
[in] Этот параметр не используется.

ptr
[in] Указатель на экземпляр IWbemClassObject .

lFlags
[in] Обычно 0. Если WBEM_FLAG_NO_FLAVORS указан (или 0x1), квалификаторы включаются без сведений о распространении или вкусе.

pstrObjectText [out] Указатель на элемент в null записи. При возврате вновь выделенный BSTR объект , содержащий синтаксическую отрисовку mof объекта.

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

Следующие значения, возвращаемые этой функцией, определяются в файле заголовка WbemCli.h или их можно определить как константы в коде:

Константа Значение Описание
WBEM_E_FAILED 0x80041001 Произошел общий сбой.
WBEM_E_INVALID_PARAMETER 0x80041008 Недействительный параметр.
WBEM_E_OUT_OF_MEMORY 0x80041006 Недостаточно памяти для выполнения операции.
WBEM_S_NO_ERROR 0 Вызов функции выполнен успешно.

Комментарии

Эта функция создает оболочку для вызова метода IWbemClassObject::GetObjectText .

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

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

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

pstrObjectText должен быть указателем на null при вызове функции; он не должен указывать на строку, допустимую до вызова метода, так как указатель не будет освобожден.

Требования

Платформы: см. раздел Требования к системе.

Заголовка: WMINet_Utils.idl

платформа .NET Framework версии: доступно с версии 4.7.2.

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