ADsFreeEnumerator function (adshlp.h)

The ADsFreeEnumerator function frees an enumerator object created with the ADsBuildEnumerator function.

Syntax

HRESULT ADsFreeEnumerator(
  [in] IEnumVARIANT *pEnumVariant
);

[in] pEnumVariant

Type: IEnumVARIANT*

Pointer to the IEnumVARIANT interface on the enumerator object to be freed.

Type: HRESULT

This method supports standard return values, as well as the following.

The general process for enumerating objects in a container is as follows.

First, create an enumerator object on that container.

Second, retrieve the IEnumVARIANT interface pointer.

Third, call the ADsEnumerateNext function to return an enumerated set of elements from the enumerator object.

Fourth, call the ADSFreeEnumerator function to free the enumerator object.

For more information and a code example, see ADsBuildEnumerator.