SWbemObject.DeleteAsync_ 方法

SWbemObject 的 DeleteAsync_ 方法异步删除当前类或当前实例。 如果动态提供程序提供类或实例，那么除非提供程序支持删除类或实例，否则有时会无法删除此对象。

有关此语法的说明，请参阅脚本 API 的文档约定。

语法

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

parameters

objWbemSink [in]

返回“删除”操作的结果的对象接收器。

iFlags [in, optional]

决定调用行为的整数。 此参数可以接受以下值。

wbemFlagSendStatus (128 (0x80))

导致异步调用将状态更新发送到对象接收器的 SWbemSink.OnProgress 事件处理程序。

wbemFlagDontSendStatus ( 0 (0x0))

防止异步调用将状态更新发送到对象接收器的 OnProgress 事件处理程序。

objwbemNamedValueSet [in, optional]

通常未定义此参数。 否则，这就是 SWbemNamedValueSet 对象，其元素表示为请求提供服务的提供程序可使用的上下文信息。 支持或需要此类信息的提供程序必须记录已识别的值名称、值数据类型、允许的值和语义。

objWbemAsyncContext [in, optional]

这是一个 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)

内存不足，无法完成此操作。

备注

立即返回此调用。 状态通过回调返回到调用方，该回调传递到 objWbemSink 中的指定接收器。

通过异步回调，未经身份验证的用户可以向接收器提供数据。 这会给脚本和应用程序带来安全风险。 为消除风险，请使用半同步通信或同步通信。 有关详细信息，请参阅调用方法。

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
标头	Wbemdisp.h
类型库	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemObject
IID	IID_ISWbemObject