Microsoft DirectX 8.1 (C++)

IObjects::AddAt

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

The AddAt method adds an object to an ordered collection at the specified index.

Syntax

HRESULT AddAt(
  IUnknown*  punk,
  long  index
);

Parameters

punk

[in]  Specifies the IUnknown interface of the object to be added.

index

[in]  Specifies the index.

Return Values

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK The method succeeded.
E_INVALIDARG This collection is not ordered.
E_POINTER Data cannot be read from or written to a supplied address.

Remarks

This method can be used only on collections retrieved by using IObjects::get_ItemsRelatedToBy.

See Also