Provider::D eleteInstance (ParsedObjectPath*,long,MethodContext*) 方法 (provider.h)

[Provider 类是 WMI 提供程序框架的一部分,现在视为处于最终状态,对于影响这些库的非安全性相关问题,将不会提供进一步的开发、增强或更新。 所有新开发均应使用 MI API。]

WMI 调用 DeleteInstance 方法以删除实例。

语法

HRESULT DeleteInstance(
  ParsedObjectPath *pParsedObjectPath,
  long             lFlags,
  MethodContext    *pContext
);

参数

pParsedObjectPath

TBD

lFlags

包含删除操作相关信息的标志的位掩码。 这是 客户端在 IWbemServices::D eleteInstance 函数中指定的值。

以下标志由 (处理,并由 WMI 筛选出) :

  • WBEM_FLAG_RETURN_IMMEDIATELY

pContext

TBD

返回值

此方法的默认框架提供程序实现将 WBEM_E_PROVIDER_NOT_CAPABLE 返回到调用函数。 IWbemServices::D eleteInstance 函数列出了最常见的返回值,不过可以选择返回任何 COM 返回代码。

注解

当客户端针对类调用 IWbemServices::D eleteInstance 时,WMI 会调用 DeleteInstance。 因此,如果框架提供程序支持删除实例,则必须实现 DeleteInstance 。 以下列表介绍了 DeleteInstance 的常见实现:

  1. 使用 CInstanceGet 方法之一(例如 CInstance::GetCHString)读取键属性来确定客户端请求的实例。
  2. 删除实例。
有关删除实例的详细信息,请参阅 IWbemServices::D eleteInstance

要求

要求
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 provider.h (包括 FwCommon.h)
Library FrameDyn.lib
DLL FrameDynOS.dll;FrameDyn.dll