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

  • Статья

Метод IWbemServices::D eleteClassAsync удаляет указанный класс из текущего пространства имен. Этот метод идентичен IWbemServices::D eleteClass , за исключением того, что вызов возвращается немедленно. Подтверждение или сбой асинхронно передаются в указанный приемник объекта с помощью метода IWbemObjectSink::SetStatus после завершения операции.

Синтаксис

HRESULT DeleteClassAsync(
  [in] const BSTR      strClass,
  [in] long            lFlags,
  [in] IWbemContext    *pCtx,
  [in] IWbemObjectSink *pResponseHandler
);

Параметры

[in] strClass

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

[in] lFlags

Одно или несколько из следующих значений являются допустимыми.

WBEM_FLAG_SEND_STATUS

Этот флаг регистрирует в службе управления Windows запрос на получение промежуточных отчетов о состоянии с помощью клиентской реализации IWbemObjectSink::SetStatus. Реализация поставщика должна поддерживать промежуточные отчеты о состоянии, чтобы этот флаг изменил поведение.

WBEM_FLAG_OWNER_UPDATE

Поставщики push-уведомлений должны указывать этот флаг при вызове DeleteClassAsync , чтобы указать, что этот класс изменился.

[in] pCtx

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

[in] pResponseHandler

Указатель на реализацию IWbemObjectSink , реализованную вызывающим объектом. Этот обработчик получает состояние запроса на удаление, когда он становится доступным с помощью метода IWbemObjectSink::SetStatus . Если возвращается какой-либо код ошибки, предоставленный указатель IWbemObjectSink не используется. Если возвращается WBEM_S_NO_ERROR , вызывается реализация IWbemObjectSink пользователя для указания результата операции. Управление Windows вызывает AddRef только для указателя в тех случаях, когда возвращается WBEM_S_NO_ERROR . В случаях, когда возвращается код ошибки, количество ссылок совпадает с числом при записи. Подробное описание этого параметра см. в разделе Вызов метода.

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

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

Все остальные коды возврата предоставляются приемнику объектов, заданному параметром pReponseHandler , с помощью метода SetStatus . Обработчику сообщаются условия ошибок, например, когда класс не существует или у пользователя нет разрешения на удаление классов. Они не отображаются в коде возврата этого метода.

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

Комментарии

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

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

Примечание Стандартные системные классы не могут быть удалены.
 
Так как обратный вызов может быть возвращен не на том же уровне проверки подлинности, который требуется клиенту, рекомендуется использовать полусинхронный режим вместо асинхронного взаимодействия. Если требуется асинхронное взаимодействие, см. статью Вызов метода.

Дополнительные сведения об использовании методов полусинхронно см. в разделах IWbemServices::D eleteClass и Вызов метода.

Требования

   
Минимальная версия клиента 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 eleteClass

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