Метод SWbemServices.DeleteAsync

Статья
06/13/2023

Метод DeleteAsync объекта SWbemServices удаляет класс или экземпляр, указанный в пути к объекту. Вызов DeleteAsync возвращается немедленно, а результаты и состояние возвращаются вызывающей объекту через события, доставляемые в приемник, указанный в objWbemSink. Дополнительные сведения о создании приемника см. в разделе Получение события WMI. Удалить объекты можно только в пространстве имен, к которому вы подключены.

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

Метод вызывается в асинхронном режиме. Дополнительные сведения см. в разделе Вызов метода .

Описание этого синтаксиса см. в разделе Соглашения о документах для API сценариев.

Синтаксис

SWbemServices.DeleteAsync( _
  [ ByVal ObjWbemSink ], _
  ByVal strObjectPath, _
  [ ByVal iFlags ], _
  [ ByVal objWbemNamedValueSet ], _
  [ ByVal objWbemAsyncContext ] _
)

Параметры

ObjWbemSink [необязательно]: Приемник объекта, получающий результаты удаления. Создайте объект SWbemSink для получения объектов.
strObjectPath: Обязательный. Строка, содержащая путь к объекту, который требуется удалить. Дополнительные сведения см. в разделе Описание расположения объекта WMI.
iFlags [необязательно]: Определяет, возвращаются ли обновления состояния. Этот параметр может принимать следующие значения.
wbemFlagSendStatus (128 (0x80)): Вызывает асинхронные вызовы для отправки обновлений состояния в обработчик событий OnProgress для приемника объекта.
wbemFlagDontSendStatus (0 (0x0)): Запрещает асинхронным вызовам отправлять обновления состояния в обработчик событий OnProgress для приемника объектов.

objWbemNamedValueSet [необязательно]

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

objWbemAsyncContext [необязательно]

Объект SWbemNamedValueSet , возвращающийся в приемник объекта для идентификации источника исходного асинхронного вызова. Используйте этот параметр, если выполняете несколько асинхронных вызовов с использованием одного и того же приемника объектов. Чтобы использовать этот параметр, создайте объект SWbemNamedValueSet и используйте метод SWbemNamedValueSet.Add , чтобы добавить значение, определяющее асинхронный вызов, который вы выполняете. Этот объект SWbemNamedValueSet возвращается в приемник объекта, а источник вызова можно извлечь с помощью метода SWbemNamedValueSet.Item . Дополнительные сведения см. в разделе Вызов метода .

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

Этот метод не возвращает значение. Если вызов выполнен успешно, приемник объекта получает уведомление об удалении.

Коды ошибок

После завершения метода DeleteAsync объект Err может содержать один из кодов ошибок в следующем списке.

wbemErrFailed — 2147749889 (0x80041001): Незаданная ошибка.
wbemErrInvalidParameter — 2147749896 (0x80041008): Указан недопустимый параметр.
wbemErrOutOfMemory — 2147749894 (0x80041006): Недостаточно памяти для завершения операции.
wbemErrTransportFailure — 2147749909 (0x80041015): Произошла ошибка сети, препятствующая нормальной работе.
wbemErrAccessDenied — 2147749891 (0x80041003): Текущие или указанные имя пользователя и пароль не являются допустимыми или не авторизованы для подключения.
wbemErrNotFound — 2147749890 (0x80041002): Запрошенный элемент не найден.

Этот вызов возвращается немедленно. Состояние операции удаления возвращается вызывающей объекту через обратный вызов, доставляемый в приемник, указанный в objWbemSink. Вы можете выполнить окончательную обработку в реализации objWbemSink. Событие OnCompleted .

Асинхронный обратный вызов позволяет пользователю, не прошедшему проверку подлинности, предоставлять данные в приемник. Это создает угрозу безопасности для сценариев и приложений. Сведения об устранении рисков см. в статье Настройка безопасности при асинхронном вызове.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Заголовок	Wbemdisp.h
Библиотека типов	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemServices
IID	IID_ISWbemServices

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

SWbemServices
SWbemObjectPath