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

  • Статья

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

Синтаксис

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

Параметры

[in] strObjectPath

Допустимый BSTR , содержащий путь к объекту , который требуется удалить.

[in] lFlags

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

[in] pCtx

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

[in] pResponseHandler

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

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

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

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

Если DeleteInstanceAsync возвращает WBEM_S_NO_ERROR, WMI ожидает результата от метода SetStatus обработчика ответа. WMI ожидает неограниченное время при локальном подключении или до истечения времени ожидания удаленного подключения.

Другие условия ошибок асинхронно передаются в приемник объектов, предоставляемый параметром pResponseHandler .

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

Примечание Клиенты, вызывающие Метод DeleteInstanceAsync , всегда должны ожидать, что результаты вызова будут сообщаться с помощью метода IWbemObjectSink::Indicate .
 
Примечание Если экземпляр, на который указывает strObjectPath , принадлежит к классу, который является членом иерархии классов, успех DeleteInstanceAsync зависит от самого верхнего неабстрактного поставщика. Подробное описание зависимостей, определяющих успешность этой операции, см. в разделе Примечания в IWbemServices::D eleteInstance.
 

Комментарии

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

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

Требования

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