IEnumLocation::Next 메서드(tapi3if.h)

Next 메서드는 열거형 시퀀스에서 지정한 다음 개수의 요소를 가져옵니다. 이 메서드는 Visual Basic 및 스크립팅 언어에서 숨겨집니다.

구문

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

[in] celt

요청된 요소 수입니다.

[out] ppElements

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

[out] pceltFetched

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

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

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

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

이 페이지가 도움이 되었나요?