다음을 통해 공유


IPGlobalProperties.GetUnicastAddressesAsync 메서드

정의

로컬 컴퓨터의 안정된 유니캐스트 IP 주소 테이블을 비동기 작업으로 검색합니다.

public:
 virtual System::Threading::Tasks::Task<System::Net::NetworkInformation::UnicastIPAddressInformationCollection ^> ^ GetUnicastAddressesAsync();
public virtual System.Threading.Tasks.Task<System.Net.NetworkInformation.UnicastIPAddressInformationCollection> GetUnicastAddressesAsync ();
abstract member GetUnicastAddressesAsync : unit -> System.Threading.Tasks.Task<System.Net.NetworkInformation.UnicastIPAddressInformationCollection>
override this.GetUnicastAddressesAsync : unit -> System.Threading.Tasks.Task<System.Net.NetworkInformation.UnicastIPAddressInformationCollection>
Public Overridable Function GetUnicastAddressesAsync () As Task(Of UnicastIPAddressInformationCollection)

반환

비동기 작업(operation)을 나타내는 작업(task) 개체입니다.

예외

네이티브 GetAdaptersAddresses 함수에 대한 호출에 실패한 경우.

호출자에게 필요한 Read 권한이 없습니다.

네이티브 NotifyStableUnicastIpAddressTable 함수에 대한 호출에 실패한 경우.

설명

아웃 바운드 연결을 지원 하기 위해 또는 Teredo 인터페이스에 들어오는 연결을 허용 하도록 애플리케이션 하 여 Teredo 인터페이스 인지 확인 하 고 사용 하기 위해 준비 해야 합니다. 일정 기간 동안 사용하지 않으면 Teredo 휴면 상태로 전환할 수 있기 때문입니다.

GetUnicastAddressesAsync 메서드의 비동기 작업으로 안정 된 유니캐스트 IP 주소의 목록을 검색 하려면 애플리케이션을 사용할 수 있습니다. 속성을 IPAddress.IsIPv6Teredo 사용하여 IP 주소가 2001::/32 접두사를 가진 IPv6 Teredo 주소인지 확인할 수 있습니다.

또한 메서드는 GetUnicastAddresses Teredo 이외의 주소를 반환하고 로컬 컴퓨터의 모든 System.Net.NetworkInformation.NetworkInterface 개체를 열거하고 연결된 IP 주소를 쿼리하는 것보다 시스템에 대한 유니캐스트 IP 주소를 가져오는 더 편리한 방법을 제공합니다.

이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 태스크에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw GetUnicastAddresses()된 예외를 참조하세요.

적용 대상

추가 정보