IMSVidFeatures::get__NewEnum method (segment.h)

[The feature associated with this page, Microsoft TV Technologies, is a legacy feature. Microsoft strongly recommends that new code does not use this feature.]

The get__NewEnum method retrieves an enumerator for the collection.

Syntax

HRESULT get__NewEnum(
  [out] IEnumVARIANT **pD
);

Parameters

[out] pD

Pointer to a variable that receives an IEnumVARIANT interface pointer.

Return value

Returns an HRESULT value. Possible values include the following.

Return code Description
S_OK
Success.
E_OUTOFMEMORY
Insufficient memory.
E_POINTER
NULL pointer argument.

Remarks

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.

Requirements

Requirement Value
Minimum supported client Windows�XP [desktop apps only]
Minimum supported server None supported
Target Platform Windows
Header segment.h (include Msvidctl.h)

See also

IMSVidFeatures Interface