ITCollection::get__NewEnum 메서드(tapi3if.h)

get__NewEnum 메서드는 컬렉션에 대한 열거자를 가져옵니다.

구문

HRESULT get__NewEnum(
  [out] IUnknown **ppNewEnum
);

매개 변수

[out] ppNewEnum

컬렉션에 대한 열거자 개체의 IUnknown 인터페이스에 대한 포인터입니다.

반환된 IUnknown 인터페이스에서 QueryInterface 메서드를 호출하여 컬렉션의 IEnumVARIANT 열거형 인터페이스에 대한 포인터를 가져옵니다. IEnumVARIANT 는 컬렉션을 반복하는 데 사용할 수 있는 여러 메서드를 제공합니다.

자세한 내용은 아래 설명 부분을 참조하십시오.

반환 값

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

반환 코드	Description
S_OK	메서드가 정상적으로 실행되었습니다.
E_OUTOFMEMORY	작업을 수행하기 위한 메모리가 부족합니다.

설명

컬렉션을 반환하는 메서드를 포함하는 각 TAPI 3 인터페이스에는 TAPI 3 열거자 인터페이스에 대한 포인터를 반환하는 메서드도 포함됩니다. C/C++에서 프로그래밍하는 경우 ITCollection::get__NewEnum 메서드를 호출하는 대신 컬렉션의 열거자 메서드를 직접 호출하여 열거자 개체를 가져오는 것이 더 쉬울 수 있습니다. 예를 들어 ITTAPI::EnumerateAddresses 메서드는 IEnumAddress 인터페이스에 대한 포인터를 반환합니다. IEnumAddress 는 Address 개체에 대한 열거형 메서드를 제공합니다.

Visual Basic에서 프로그래밍하는 경우 컬렉션을 열거하기 위해 이 메서드를 호출할 필요가 없습니다. 이는 For...를 사용하여 메서드의 기능을 암시적으로 호출할 수 있기 때문입니다. 각... 에서... 다음... 생성.

요구 사항

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

추가 정보

ITCollection