Бөлісу құралы:

Функция SpawnInstance

Создает экземпляр класса.

Примечание

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

Синтаксис

HRESULT SpawnInstance (
   [in] int                  vFunc,
   [in] IWbemClassObject*    ptr,
   [in] LONG                 lFlags,
   [out] IWbemClassObject**  ppNewInstance);

Параметры

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

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

lFlags
[in] Зарезервировано. Этот параметр должен иметь значение 0.

ppNewInstance
[out] Получает указатель на новый экземпляр класса . При возникновении ошибки новый объект не возвращается и ppNewInstance остается без изменений.

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

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

Константа Значение Описание
WBEM_E_INCOMPLETE_CLASS 0x80041020 ptr не является допустимым определением класса и не может порождать новые экземпляры. Оно является неполным или не зарегистрировано в системе управления Windows путем вызова Метода PutClassWmi.
WBEM_E_OUT_OF_MEMORY 0x80041006 Недостаточно памяти для выполнения операции.
WBEM_E_INVALID_PARAMETER 0x80041008 ppNewClass имеет значение null.
WBEM_S_NO_ERROR 0 Вызов функции выполнен успешно.

Комментарии

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

ptr должно быть определением класса, полученным из службы управления Windows. (Обратите внимание, что создание экземпляра из экземпляра поддерживается, но возвращенный экземпляр пуст.) Затем вы используете это определение класса для создания новых экземпляров. Если вы планируете записать экземпляр в управление Windows, требуется вызов функции PutInstanceWmi .

Новый объект, возвращенный в ppNewClass , автоматически становится подклассом текущего объекта . Это поведение не может быть переопределено. Не существует другого метода, с помощью которого можно создать подклассы (производные классы).

Требования

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

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

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

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

  • Last updated on