IEnumVARIANTUnrestricted interface

Enumerates a sequence of Variant values, with counts declared as Long values.

IEnumVARIANTUnrestricted has the interface identifier 00020404-0000-0000-C000-000000000046, which is the identifier of IEnumVARIANT, the enumerator that For Each uses. It is declared [OleAutomation(False)]. Microsoft Learn describes the Windows interface: IEnumVARIANT.

Declaration

The enumerator declared in stdole cannot be implemented from twinBASIC, because its counts are unsigned 32-bit integers, which twinBASIC has no type for. This declaration uses Long counts instead. Its cElt parameters are Long, and so is pcEltFetched, which is passed by value.

The declaration extends stdole.IDispatch. The Windows IEnumVARIANT extends IUnknown.

The declaration is complete: it has all four methods of the Windows interface. Each is a Sub, so the HRESULT is hidden: a failure code raises a run-time error, and a success code such as S_FALSE is read with Err.LastHresult. The IEnumVARIANT page in the COM Interfaces section gives the contract of the four methods, how For Each uses them, and a project’s own declaration of the interface.

Methods

Sub Next(ByVal cElt As Long, ByRef rgVar As Variant, ByVal pcEltFetched As Long)

Returns the next cElt items of the sequence, or as many as are left. rgVar is the first element of the caller’s array of Variant values, which receives the items. pcEltFetched is the number of items fetched, as a pointer in the Windows method. It is a 32-bit Long here, so it can hold a pointer only in 32-bit code; a caller that does not need the count passes 0, which is a null pointer. A call that returns fewer items than asked for returns S_FALSE.

Skip

Sub Skip(ByVal cElt As Long)

Skips the next cElt items of the sequence. It returns S_FALSE when fewer than cElt items were left.

Reset

Sub Reset()

Returns to the first item of the sequence.

Clone

Sub Clone(ByRef ppEnum As stdole.IEnumVARIANT)

Returns, in ppEnum, a copy of the enumerator that starts at the same position. The two then advance independently. The type of ppEnum is stdole.IEnumVARIANT.