SWbemPropertySet.Add method

The Add method of the SWbemPropertySet object adds an SWbemProperty object to the SWbemPropertySet collection. If a property with the same name already exists in the collection, its contents are replaced with the new definition.

Note

The value of the added property is NULL (unassigned) after this operation. To set or change the value of a WMI property, you must set the Value property of the returned SWbemProperty object.

For an explanation of this syntax, see Document Conventions for the Scripting API.

Syntax

objProperty = .Add( _
  ByVal strName, _
  ByVal iCIMType, _
  [ ByVal bIsArray ], _
  [ ByVal iFlags ] _
)

Parameters

strName [in]

Required. Name of the new property.

iCIMType [in]

Required. An integer that represents the CIMType qualifier of the new property. See WbemCimTypeEnum for the list with the CIMType qualifiers and their values.

bIsArray [in, optional]

Specifies whether the property is an array type. The default value for this parameter is FALSE.

iFlags [in, optional]

Reserved and must be zero if specified.

Return value

If successful, this method returns an SWbemProperty object that represents the new property. Otherwise, a null object is returned.

Error codes

After completion of the Add method, the Err object may contain one of the error codes below.

wbemErrFailed - 2147749889 (0x80041001)

Unspecified failure.

wbemErrInvalidParameter - 2147749896 (0x80041008)

Invalid parameter was specified.

wbemErrOutOfMemory - 2147749894 (0x80041006)

Not enough memory for this method to execute.

wbemErrInvalidPropertyType - 2147749930

The CIMType qualifier is not recognized.

Examples

For a code example that uses this method, see the SWbemPropertySet topic.

Requirements

Minimum supported client
Windows Vista
Minimum supported server
Windows Server 2008
Header
Wbemdisp.h
Type library
Wbemdisp.tlb
DLL
Wbemdisp.dll
CLSID
CLSID_SWbemPropertySet
IID
IID_ISWbemPropertySet

See also

SWbemPropertySet

SWbemPropertySet.Remove

SWbemProperty.Value