描述

 

IWbemServices.DeleteInstance方法删除当前命名空间中现有类的实例。

 

C++ 语法

 

 

PowerBASIC 语法

 

 

参数

 

strObjectPath

 

有效BSTR包含要删除的实例的对象路径。

 

lFlags

 

以下值之一是有效的。

 

 

pCtx

 

通常为NULL。否则，这是指向正在删除实例的提供者可能使用的IWbemContext对象的指针。必须在相关提供者的文档中指定上下文对象中的值。

 

ppCallResult

 

如果为NULL，则不使用此参数。如果指定ppCallResult，则必须将其设置为指定为NULL。如果lFlags参数包含WBEM_FLAG_RETURN_IMMEDIATELY，此调用将立即返回WBEM_S_NO_ERROR。ppCallResult参数接收一个指向新的IWbemCallResult对象的指针，然后可以使用GetCallStatus方法轮询获取结果。

 

返回值

 

此方法返回一个HRESULT，表示方法调用的状态。下表列出了HRESULT中包含的值。

 

失败时，您可以从COM函数GetErrorInfo获取任何可用的信息。

 

如果网络问题导致您失去与Windows Management的远程连接，也可能会返回COM特定的错误代码。

 

 

备注

 

调用IWbemServices.DeleteInstance方法来删除当前命名空间中的现有实例。其他命名空间中的实例无法删除。调用DeleteInstance以删除属于层次结构中的类的实例时，Windows Management将为层次结构中负责非抽象类的所有提供者调用DeleteInstanceAsync方法。也就是说，如果strObjectPath参数标识ClassB的一个实例，ClassB派生自ClassA，非抽象类，并且是ClassC和ClassD的父类，也是非抽象类，则调用所有四个类的提供程序。

 

Windows Management将调用每个提供程序，并将对象路径修改为指向其类。例如，如果原始调用的strObjectPath设置为“ClassB.k = 1”，则对ClassA提供程序的调用将将strObjectPath设置为“ClassA.k = 1”。

 

DeleteInstance呼叫的成功仅取决于对最高非抽象类的提供者的DeleteInstanceAsync调用的成功。非抽象类有一个抽象类作为其父类。如果任何一个类的提供者成功，则操作成功;如果所有这些类都失败，则操作失败。

 

例如，假设ClassX是以下层次结构的基类：

 

 

如果ClassX是层次结构中唯一的抽象类，并且DeleteInstance中的strObjectPath参数指向ClassB的实例，则只有ClassA的提供者需要在其DeleteInstanceAsync调用中成功。

 

如果ClassX，ClassA和ClassB都是抽象的，并且DeleteInstance中的strObjectPath参数再次指向ClassB的实例，则ClassC的提供者或ClassD的提供者必须成功。

 

要求