勇芳软件工作室.汉化:  Windows Management Instrumentation > COM API for WMI > Interfaces > IWbemClassObject >

SpawnInstance Method

Previous pageReturn to chapter overviewNext page

描述

 

使用IWbemClassObject,SpawnInstance方法创建一个类的新实例。当前对象必须是使用IWbemServices.GetObjectIWbemServices.CreateClassEnumIWbemServices.CreateClassEnumAsync从Windows Management获取的类定义。然后,使用此类定义创建新实例。

 

需要调用IWbemServices.PutInstance才能将实例写入Windows Management。如果您打算在致电IWbemServices.PutInstance之前丢弃该对象,只需致电IWbemClassObject.Release.

 

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

 

C++ 语法

 

HRESULT SpawnInstance(

[in]   LONG lFlags,

[out]  IWbemClassObject **ppNewInstance

);

 

PowerBASIC 语法

 

METHOD SpawnInstance ( _

BYVAL lFlags AS LONG, _

BYREF ppNewInstance AS IWbemClassObject _

) AS LONG

 

参数

 

lFlags

 

保留。该参数必须为0。

 

ppNewInstance

 

不能为空。它收到一个新的类的实例。出现错误时,不会返回一个新对象,并且指针未被修改。

 

返回值

 

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

 

退货代码

描述

WBEM_E_INCOMPLETE_CLASS

当前对象不是有效的类定义,不能生成新的实例。或者它是不完整的,或者没有使用PutClass在Windows Management中注册。

WBEM_E_INVALID_PARAMETER

指定了无效参数。

WBEM_E_OUT_OF_MEMORY

没有足够的内存来完成操作。

WBEM_S_NO_ERROR

通话成功。

 

要求

 

客户

需要Windows Vista,Windows XP,Windows 2000 Professional,Windows NT Workstation 4.0 SP4及更高版本,Windows Me,Windows 98或Windows 95。

服务器

需要Windows Server 2008,Windows Server 2003,Windows 2000 Server或Windows NT Server 4.0 SP4及更高版本。

在Wbemcli.inc中声明。

DLL

需要Cimwin32.dll。

需要Esscli.dll。

需要Evntrprv.dll。

需要Fastprox.dll。

需要Framedyn.dll。

需要Krnlprov.dll。

需要Ncprov.dll。

需要Wbemcore.dll。

需要Wbemess.dll。

需要Wmipiprt.dll。