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