ADsEnumerateNext 函数 (adshlp.h)

项目
02/23/2024

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