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