영어로 읽기

다음을 통해 공유


IEnumAgent::Next 메서드(tapi3.h)

Next 메서드는 열거형 시퀀스에서 지정된 다음 개수의 요소를 가져옵니다.

구문

HRESULT Next(
  [in]  ULONG   celt,
  [out] ITAgent **ppElements,
  [out] ULONG   *pceltFetched
);

매개 변수

[in] celt

요청된 요소 수입니다.

[out] ppElements

ITAgent 포인터에 대한 포인터입니다.

[out] pceltFetched

실제로 제공된 요소 수에 대한 포인터입니다. celt가 하나인 경우 NULL일 수 있습니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

의미
S_OK
메서드는 셀트 수의 요소를 반환했습니다.
S_FALSE
남은 요소 수가 켈트보다 적습니다.
E_POINTER
ppElements 매개 변수가 유효한 포인터가 아닙니다.
E_OUTOFMEMORY
작업을 수행하기 위한 메모리가 부족합니다.

설명

TAPI는 IEnumAgent::Next에서 반환된 ITAgent 인터페이스에서 AddRef 메서드를 호출합니다. 애플리케이션은 ITAgent 인터페이스에서 Release를 호출하여 연결된 리소스를 해제해야 합니다.

요구 사항

   
대상 플랫폼 Windows
헤더 tapi3.h(Tapi3.h 포함)
라이브러리 Uuid.lib
DLL Tapi3.dll

추가 정보

IEnumAgent

ITAgent