ITTAPI::EnumerateAddresses 메서드(tapi3if.h)

아티클
03/02/2024

EnumerateAddresses 메서드는 현재 사용할 수 있는 주소를 열거합니다. C 및 C++ 애플리케이션에 제공됩니다. Visual Basic으로 작성된 애플리케이션과 같은 Automation 클라이언트 애플리케이션은 get_Addresses 메서드를 사용해야 합니다.

구문

HRESULT EnumerateAddresses(
  [out] IEnumAddress **ppEnumAddress
);

매개 변수

[out] ppEnumAddress

IEnumAddress 인터페이스에 대한 포인터입니다.

반환 값

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

값	의미
S_OK	메서드가 정상적으로 실행되었습니다.
E_POINTER	ppEnumAddress 매개 변수가 유효한 포인터가 아닙니다.
E_INVALIDARG	TAPI 개체가 초기화되지 않았습니다.
E_OUTOFMEMORY	메모리가 부족하여 작업을 수행할 수 없습니다.

설명

애플리케이션은 일반적으로 이 열거형을 사용하여 각 주소의 기능을 검사 현재 용도에 유용한 기능을 결정합니다.

예상 주소를 찾을 수 없는 경우 적절한 서비스 공급자가 설치되지 않았거나 제대로 작동하지 않음을 나타낼 수 있습니다.

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

TAPI 세션 중에 주소를 만들거나 제거하면 ITTAPIEventNotification 인터페이스를 통해 애플리케이션에 알림이 표시됩니다. 플러그 앤 플레이 디바이스를 설치하는 등 주소를 만든 경우 ITTAPIEventNotification::Event는 TAPIOBJECT_EVENT 열거형의 TE_ADDRESSCREATE 멤버를 반환합니다. 주소가 제거되면 ITTAPIEventNotification::Event 는 TE_ADDRESSREMOVE 반환합니다. 이러한 이벤트 이후에 EnumerateAddresses를 호출하면 현재 주소가 반영됩니다.