IWbemClassObject::SpawnInstance 方法 (wbemcli.h)

使用 IWbemClassObject::SpawnInstance 方法创建类的新实例。 当前对象必须是使用 IWbemServices::GetObject、IWbemServices::CreateClassEnum 或IWbemServices::CreateClassEnumAsync 从 Windows 管理获取的类定义。然后,使用此类定义创建新实例。

需要调用 IWbemServices::P utInstance 才能将实例实际写入 Windows 管理。 如果打算在调用 IWbemServices::P utInstance 之前放弃对象,只需调用 IWbemClassObject::Release 即可。

请注意,支持从 实例生成实例,但返回的实例将为空。

语法

HRESULT SpawnInstance(
  [in]  long             lFlags,
  [out] IWbemClassObject **ppNewInstance
);

参数

[in] lFlags

保留。 此参数必须为 0。

[out] ppNewInstance

不能为 NULL。 它接收 类的新实例。 当不再需要指针时,调用方必须调用 IWbemClassObject::Release 。 出错时,不会返回新对象,并且指针保持未修改。

返回值

此方法返回指示方法调用状态的 HRESULT。 以下列表列出了 HRESULT 中包含的值。 有关常规 HRESULT 值,请参阅 系统错误代码

要求

   
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 wbemcli.h (包括 Wbemidl.h)
Library WbemUuid.lib
DLL CIMWin32.dll;Esscli.dll;Fastprox.dll;FrameDyn.dll;FrameDynOS.dll;Krnlprov.dll;Ncprov.dll;Wbemcore.dll;Wbemess.dll;Wmipiprt.dll

另请参阅

IWbemClassObject

IWbemServices::GetObject

IWbemServices::PutInstance