Microsoft DirectX 8.1 (C++)

MetaPropertySets.AddNew

This topic applies to Windows XP Home Edition and Windows XP Professional only.

The AddNew property retrieves or adds a MetaPropertySet object. If the MetaPropertySet object already exists, it is retrieved. Otherwise, a new MetaPropertySet object is created and added to this MetaPropertySets object collection. The new MetaPropertySet object is then returned.

Syntax

objMetaPropertySets.AddNew(
  strName As String) As MetaPropertySet

Parameters

strName

[in]  Specifies the name of the MetaPropertySet object.

Error Codes

If the property fails, an error is raised and Err.Number is set to a value other than zero.

Return Values

This property returns a MetaPropertySet object.

Remarks

When the property completes, if strIID was already a MetaPropertySet object, then that MetaPropertySet object will be returned. Otherwise, a new MetaPropertySet object will be added containing strIID and strName. The new MetaPropertySet object will be returned.

See Also