Microsoft DirectX 9.0


This topic applies to Windows XP only.

The get__NewEnum method retrieves an enumerator for the collection.


HRESULT get__NewEnum(
  IEnumVARIANT**  ppD



[out]  Pointer to a variable that receives an IEnumVARIANT interface pointer.

Return Values

Returns an HRESULT value. Possible values include the following.

Value Description
S_OK Success.
E_OUTOFMEMORY Insufficient memory.
E_POINTER NULL pointer argument.


This method is provided so that Automation clients can iterate through the collection using a For...Each loop.

The returned IEnumVARIANT interface is not thread safe, because it is intended primarily for use by Automation clients. Clients should not call methods on the interface from more than one thread. (C++ applications should generally use the IMSVidFeatures::get_Item method instead.)

If the method succeeds, the IEnumVARIANT interface has an outstanding reference count. The caller must release the interface.

See Also