Метод IWbemServices::D eleteClass (wbemcli.h)

Статья
03/03/2024

Метод IWbemServices::D eleteClass удаляет указанный класс из текущего пространства имен. Если поставщик динамических экземпляров связан с классом, он отменяется и больше не вызывается этим классом. Все классы, производные от удаленного класса, также удаляются, а связанные с ними поставщики отменяются. Все невыполненные статические экземпляры указанного класса и его подклассов также удаляются при удалении класса.

Если поставщик динамических классов предоставляет класс, успех удаления зависит от того, поддерживает ли поставщик удаление класса.

Примечание Системные классы не могут быть удалены.

Синтаксис

HRESULT DeleteClass(
  [in]  const BSTR      strClass,
  [in]  long            lFlags,
  [in]  IWbemContext    *pCtx,
  [out] IWbemCallResult **ppCallResult
);

Параметры

[in] strClass

Имя класса, предназначенного для удаления.

[in] lFlags

Можно задать одно из следующих значений.

WBEM_FLAG_RETURN_IMMEDIATELY

Этот флаг приводит к полусинхронному вызову. Дополнительные сведения см. в разделе Вызов метода.

WBEM_FLAG_OWNER_UPDATE

Указывает, что вызывающий объект является поставщиком push-уведомлений.

[in] pCtx

Обычно имеет значение NULL. В противном случае это указатель на объект IWbemContext , который может использоваться поставщиком, удаляющим класс. Значения в объекте контекста должны быть указаны в документации для соответствующего поставщика. Дополнительные сведения об этом параметре см. в разделе Выполнение вызовов WMI.

[out] ppCallResult

Если значение РАВНО NULL, этот параметр не используется. Если указан параметр ppCallResult , ему необходимо задать значение NULL для записи. Если параметр lFlags содержит WBEM_FLAG_RETURN_IMMEDIATELY, этот вызов немедленно возвращается с WBEM_S_NO_ERROR. Параметр ppCallResult получает указатель на новый объект IWbemCallResult , который затем можно опрашивать для получения результата с помощью метода GetCallStatus .

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

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

В случае сбоя можно получить любые доступные сведения из функции COM GetErrorInfo.

Коды ошибок COM также могут быть возвращены, если проблемы с сетью приводят к потере удаленного подключения к управлению Windows.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	wbemcli.h (включая Wbemidl.h)
Библиотека	Wbemuuid.lib
DLL	Fastprox.dll; Esscli.dll; FrameDyn.dll; FrameDynOS.dll; Ntevt.dll; Stdprov.dll; Viewprov.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wbemsvc.dll; Wmipicmp.dll; Wmidcprv.dll; Wmipjobj.dll; Wmiprvsd.dll

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

IWbemServices

IWbemServices::D eleteClassAsync

Получение кода ошибки

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