Microsoft DirectX 8.1 (C++)

Objects.AddNew

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

The AddNew property retrieves a new object and adds it to the collection.

Syntax

objObjects.AddNew As Unknown

Parameters

This property takes no parameters.

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 an Object.

Remarks

The object is of the type appropriate to the parent collection. If the collection is a generic Objects collection, the new object supports only the IUnknown interface. However, the object can have metaproperties, which are retrieved by using GuideStore.MetaPropertiesOf. The object can also be involved in relationships with other objects.

This method is valid only for collections retrieved by using GuideStore.Objects or Objects.ItemsWithType.

See Also