IPGlobalProperties.GetUnicastAddressesAsync Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mengambil tabel alamat IP unicast yang stabil di komputer lokal sebagai operasi asinkron.
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)
Mengembalikan
Objek tugas yang mewakili operasi asinkron.
Pengecualian
Panggilan ke fungsi asli GetAdaptersAddresses
gagal.
Pemanggil tidak memiliki izin yang diperlukan Read .
Panggilan ke fungsi asli NotifyStableUnicastIpAddressTable
gagal.
Keterangan
Untuk mendukung koneksi keluar atau menerima koneksi masuk pada antarmuka Teredo, aplikasi perlu memastikan bahwa antarmuka Teredo siap digunakan. Ini karena Teredo dapat masuk ke status tidak aktif ketika tidak digunakan untuk beberapa periode waktu.
Metode ini GetUnicastAddressesAsync akan memungkinkan aplikasi untuk mengambil daftar alamat IP unicast yang stabil sebagai operasi asinkron. IPAddress.IsIPv6Teredo Properti dapat digunakan untuk menentukan apakah alamat IP adalah alamat IPv6 Teredo dengan awalan 2001::/32.
Metode ini GetUnicastAddresses juga mengembalikan alamat non-Teredo dan menyediakan cara yang lebih nyaman untuk mendapatkan alamat IP unicast untuk sistem daripada menghitung semua System.Net.NetworkInformation.NetworkInterface objek di komputer lokal dan mengkueri alamat IP terkait.
Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh GetUnicastAddresses().