Метод SWbemObject.DeleteAsync_

Статья
06/13/2023

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

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

Синтаксис

SWbemObject.DeleteAsync_( _
  ByVal objWbemSink, _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ], _
  [ ByVal objWbemAsyncContext ] _
)

Параметры

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

objwbemNamedValueSet [in, необязательный]

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

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

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

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

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

Коды ошибок

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

wbemErrAccessDenied — 2147749891 (0x80041003): Текущий контекст не имеет достаточных прав безопасности для удаления объекта.
wbemErrFailed — 2147749890 (0x80041002): Незаданная ошибка.
wbemErrInvalidClass — 2147749904 (0x80041010): Указанный класс не существует.
wbemErrInvalidOperation — 2147749910 (0x80041016): Невозможно удалить объект.
wbemErrNotFound — 2147749890 (0x80041002): Объект не существует.
wbemErrOutOfMemory — 2147749894 (0x80041006): Недостаточно памяти для завершения операции.

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

Требования

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

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