ADsEnumerateNext

Populates a VARIANT arrray with elements fetched from the indicated enumerator object.

HRESULT ADsEnumerateNext(
  IEnumVARIANT *pEnumVariant,  //Enumerator object
  ULONG cElements,             //Number of elements requested
  VARIANT FAR *pvar,           //Array of values fetched
  ULONG FAR *pcElementsFetched  //Number of elements fetched
);
 

Parameters

pEnumVariant

[in] Pointer to the IEnumVARIANT interface on the enumerator object.

cElements

[in] Number of elements requested.

pvar

[in] Pointer to the array of elements retrieved.

pcElementsFetched

[out] Actual number of elements retrieved, which can be smaller than the number of elements requested.

Return Values

This method supports the standard return values E_FAIL and E_UNEXPECTED, as well as the following:

S_OK

The VARIANT array has been populated successfully.

Remarks

The ADsEnumerateNext helper function populates a VARIANT array with elements fetched from an enumerator object. The number of elements retrieved can be smaller than the number requested.

QuickInfo

  Windows NT: Use version 4.0 and later.
  Windows CE: Unsupported.

See Also

ADsBuildEnumerator, ADsFreeEnumerator