ADsEnumerateNext 函数 (adshlp.h)

ADsEnumerateNext 函数通过枚举器的当前游标位置中的指定数量的元素进行枚举。 操作成功后,该函数返回变量数组中的枚举元素集。 返回的元素数可以小于指定的数字。

语法

HRESULT ADsEnumerateNext(
  [in]  IEnumVARIANT *pEnumVariant,
  [in]  ULONG        cElements,
  [out] VARIANT      *pvar,
  [out] ULONG        *pcElementsFetched
);

参数

[in] pEnumVariant

类型: IEnumVARIANT*

指向枚举器对象上的 IEnumVARIANT 接口的指针。

[in] cElements

类型: ULONG

请求的元素数。

[out] pvar

类型: VARIANT*

指向检索的元素数组的指针。

[out] pcElementsFetched

类型: ULONG*

检索到的实际元素数,这可能小于请求的元素数。

返回值

类型: HRESULT

此方法支持标准返回值。

有关其他返回值的详细信息,请参阅 ADSI 错误代码

注解

枚举容器中的对象的常规过程涉及以下内容:

首先,在该容器上创建枚举器对象。

其次,检索 IEnumVARIANT 接口指针。

第三,调用 ADsEnumerateNext 函数以从枚举器对象返回一组枚举的元素。

第四,调用 ADSFreeEnumerator 函数以释放枚举器对象。

有关详细信息和代码示例,请参阅 ADsBuildEnumerator 主题。

要求

   
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 adshlp.h
Library Activeds.lib
DLL Activeds.dll

另请参阅

ADSI 错误代码

ADSI 函数

ADsBuildEnumerator

ADsFreeEnumerator

FreeADsMem

IEnumVARIANT