NetworkInformation.GetInternetConnectionProfile Metode

Definisi

Ruang nama:

Windows.Networking.Connectivity

Mengambil profil koneksi yang terkait dengan antarmuka pilihan yang saat ini digunakan oleh komputer lokal. Antarmuka yang disukai adalah antarmuka yang paling mungkin mengirim atau menerima lalu lintas internet. Ini berarti bahwa profil yang dikembalikan mungkin atau mungkin tidak memiliki akses internet.

public:
 static ConnectionProfile ^ GetInternetConnectionProfile();

 static ConnectionProfile GetInternetConnectionProfile();

public static ConnectionProfile GetInternetConnectionProfile();

function getInternetConnectionProfile()

Public Shared Function GetInternetConnectionProfile () As ConnectionProfile

Mengembalikan

ConnectionProfile

Profil koneksi yang terkait dengan antarmuka pilihan , atau null jika tidak ada profil koneksi dengan koneksi yang sesuai.

Keterangan

Untuk diberi tahu tentang perubahan konektivitas, daftarkan handler dengan peristiwa NetworkStatusChanged . Ketika pemberitahuan diterima dari perubahan status jaringan, panggil metode GetInternetConnectionProfile untuk mendapatkan profil koneksi saat ini yang kemudian dapat disimpan untuk digunakan nanti saat diperlukan.

Contoh berikut menunjukkan cara mengambil ConnectionProfile. Fungsi ini memanggil GetInternetConnectionProfile untuk mengambil ConnectionProfile yang mewakili koneksi yang saat ini paling mungkin digunakan untuk konektivitas internet. Atau, aplikasi Anda dapat memanggil GetConnectionProfiles untuk mengambil semua koneksi yang tersedia di perangkat.

Catatan

Untuk implementasi metode GetConnectionProfileInfo dalam kode di bawah ini, dan untuk contoh tambahan tentang bagaimana metode kelas NetworkInformation diterapkan untuk mengambil profil koneksi, lihat Mulai Cepat: Mengambil informasi koneksi jaringan.

using Windows.Networking.Connectivity;

// Retrieve the ConnectionProfile.
ConnectionProfile internetConnectionProfile = NetworkInformation.GetInternetConnectionProfile();

// Pass the returned object to a function that accesses the connection data.
string connectionProfileInfo = GetConnectionProfileInfo(internetConnectionProfile);

#include <winrt/Windows.Networking.Connectivity.h>
using namespace winrt;

std::wstring GetConnectionProfileInfo(Windows::Networking::Connectivity::ConnectionProfile const& connectionProfile)
{
    ...
}

int main()
{
    winrt::init_apartment();

    // Retrieve the ConnectionProfile.
    auto internetConnectionProfile{ Windows::Networking::Connectivity::NetworkInformation::GetInternetConnectionProfile() };

    // Pass the returned object to a function that accesses the connection data.
    std::wstring strConnectionProfileInfo{ GetConnectionProfileInfo(internetConnectionProfile) };
}

using namespace Windows::Networking::Connectivity;

// Retrieve the ConnectionProfile.
ConnectionProfile^ internetConnectionProfile = NetworkInformation::GetInternetConnectionProfile();

// Pass the returned object to a function that accesses the connection data.
String^ strConnectionProfileInfo = GetConnectionProfileInfo(internetConnectionProfile);

Jika lebih dari satu profil koneksi saat ini menghubungkan komputer ke internet, profil pilihan dikembalikan oleh metode ini. Profil yang disukai mewakili koneksi yang paling mungkin digunakan saat mengirim dan menerima lalu lintas ke dan dari internet.