勇芳软件工作室.汉化:  Windows Management Instrumentation > Scripting API for WMI > Scripting API Objects > SWbemPropertySet >

Add Method

Previous pageReturn to chapter overviewNext page

描述

 

SWbemPropertySet对象的方法将SWbemPropertySet对象添加到SWbemPropertySet集合。如果集合中已经存在具有相同名称的属性,则其内容将替换为新定义。

 

注意此操作后,添加的属性的值为NULL(未分配)。要设置或更改WMI属性的值,必须设置返回的SWbemProperty对象的属性。

 

PowerBASIC 语法

 

METHOD Add ( _

BYVAL strName AS WSTRING, _

BYVAL iCIMType AS LONG, _

OPTIONAL BYVAL bIsArray AS INTEGER, _

OPTIONAL BYVAL iFlags AS LONG _

) AS ISWbemProperty

 

参数

 

strName

 

BSTR.需要。新财产的名称。

 

iCIMType

 

LONG.需要。表示新属性的CIMType限定符的整数。有关CIMType限定词及其值的表格,请参阅WbemCimTypeEnum.

 

bIsArray

 

VARIANT_BOOL.指定属性是否是数组类型。该参数的默认值为FALSE。

 

iFlags

 

LONG.保留,如果指定,必须为零。

 

返回值

 

如果成功,此方法返回一个代表新属性的SWbemProperty对象。否则返回一个空对象。

 

OBJRESULT

 

错误(名称/十进制/十六进制)

含义

wbemErrFailed

-2147217407

&H80041001

未指定的故障

wbemErrInvalidParameter

-2147217400

&H80041008

指定了无效参数。

wbemErrOutOfMemory

-2147217402

&H80041006

没有足够的内存来执行此方法。

wbemErrInvalidPropertyType

-2147217366

&H8004102A

CIMType限定词无法识别。

 

要求

 

客户

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

服务器

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

类型库

使用Wbemdisp.tlb。

Wbemdisp.inc。

DLL

需要Wbemdisp.dll。