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 |
| 라이브러리 | Activeds.lib |
| DLL | Activeds.dll |