IEnumString::Next 메서드(objidl.h)

열거형 시퀀스에서 지정된 수의 항목을 검색합니다.

구문

HRESULT Next(
  [in]  ULONG    celt,
  [out] LPOLESTR *rgelt,
  [out] ULONG    *pceltFetched
);

[in] celt

검색할 항목 수입니다. 시퀀스에 남아 있는 요청된 항목 수보다 적은 경우 이 메서드는 나머지 요소를 검색합니다.

[out] rgelt

열거된 항목의 배열입니다.

열거자는 메모리를 할당해야 하며 호출자는 메모리를 해제할 책임이 있습니다. celt가 1보다 큰 경우 호출자는 해제할 포인터 수를 알기 위해 pceltFetched에 전달된 NULL이 아닌 포인터도 전달해야 합니다.

[out] pceltFetched

검색된 항목 수입니다. 이 매개 변수는 항상 요청된 항목 수보다 작거나 같습니다.

메서드가 요청된 항목 수를 검색하면 반환 값이 S_OK. 그렇지 않으면 S_FALSE.

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	objidl.h(ObjIdl.h 포함)