Bagikan melalui

NetworkOperatorTetheringManager.CreateFromConnectionProfile Metode

  • Referensi

Definisi

Ruang nama:
Windows.Networking.NetworkOperators

Overload

CreateFromConnectionProfile(ConnectionProfile)

Membuat NetworkOperatorTetheringManager menggunakan profil yang diberikan sebagai antarmuka publik dan Wi-Fi sebagai antarmuka privat.
CreateFromConnectionProfile(ConnectionProfile, NetworkAdapter)

Membuat NetworkOperatorTetheringManager menggunakan profil yang diberikan sebagai antarmuka publik, dan pada NetworkAdapter yang diberikan sebagai antarmuka privat.

CreateFromConnectionProfile(ConnectionProfile)

Edit

Membuat NetworkOperatorTetheringManager menggunakan profil yang diberikan sebagai antarmuka publik dan Wi-Fi sebagai antarmuka privat.

public:
 static NetworkOperatorTetheringManager ^ CreateFromConnectionProfile(ConnectionProfile ^ profile);
 static NetworkOperatorTetheringManager CreateFromConnectionProfile(ConnectionProfile const& profile);
/// [Windows.Foundation.Metadata.Overload("CreateFromConnectionProfile")]
 static NetworkOperatorTetheringManager CreateFromConnectionProfile(ConnectionProfile const& profile);
public static NetworkOperatorTetheringManager CreateFromConnectionProfile(ConnectionProfile profile);
[Windows.Foundation.Metadata.Overload("CreateFromConnectionProfile")]
public static NetworkOperatorTetheringManager CreateFromConnectionProfile(ConnectionProfile profile);
function createFromConnectionProfile(profile)
Public Shared Function CreateFromConnectionProfile (profile As ConnectionProfile) As NetworkOperatorTetheringManager

Parameter

profile
ConnectionProfile

Profil koneksi yang akan digunakan.

Mengembalikan

NetworkOperatorTetheringManager

Objek manajer yang dihasilkan.

Atribut
OverloadAttribute

Persyaratan Windows

Kemampuan aplikasi
wiFiControl

Keterangan

Dalam rilis sebelumnya, hanya aplikasi istimewa dari operator jaringan yang dapat membuat objek NetworkOperatorTetheringManager dan menggunakannya untuk mengontrol tethering. Dalam rilis ini, aplikasi apa pun dapat membuat objek dengan memanggil CreateFromConnectionProfile. Namun, agar panggilan berhasil, aplikasi harus memiliki kemampuan perangkat kontrol Wi-Fi yang sesuai yang dideklarasikan dalam manifesnya. Contoh berikut menunjukkan bagian dari manifes dengan tag DeviceCapability yang diperlukan, dengan atribut wiFiControl .

<Capabilities>
  <DeviceCapability Name="wiFiControl"/>
</Capabilities>

Jika kemampuan perangkat wiFiControl tidak diatur dalam manifes, maka panggilan ke CreateFromConnectionProfile gagal dengan melemparkan pengecualian.

Kode Anda dapat menentukan apakah kemampuan diatur pada runtime dengan memanggil GetTetheringCapabilityFromConnectionProfile. Jika DisabledBySystemCapability dikembalikan, manifes tidak mengatur kemampuan perangkat yang diperlukan. Perhatikan bahwa meskipun Diaktifkan dikembalikan, kode Anda harus ditulis untuk menangani kesalahan dan pengecualian, karena kemampuan tethering dapat berubah kapan saja, di luar kontrol atau pemberitahuan aplikasi Anda.

Lihat juga

Berlaku untuk

CreateFromConnectionProfile(ConnectionProfile, NetworkAdapter)

Edit

Membuat NetworkOperatorTetheringManager menggunakan profil yang diberikan sebagai antarmuka publik, dan pada NetworkAdapter yang diberikan sebagai antarmuka privat.

public:
 static NetworkOperatorTetheringManager ^ CreateFromConnectionProfile(ConnectionProfile ^ profile, NetworkAdapter ^ adapter);
/// [Windows.Foundation.Metadata.Overload("CreateFromConnectionProfileWithTargetAdapter")]
 static NetworkOperatorTetheringManager CreateFromConnectionProfile(ConnectionProfile const& profile, NetworkAdapter const& adapter);
[Windows.Foundation.Metadata.Overload("CreateFromConnectionProfileWithTargetAdapter")]
public static NetworkOperatorTetheringManager CreateFromConnectionProfile(ConnectionProfile profile, NetworkAdapter adapter);
function createFromConnectionProfile(profile, adapter)
Public Shared Function CreateFromConnectionProfile (profile As ConnectionProfile, adapter As NetworkAdapter) As NetworkOperatorTetheringManager

Parameter

profile
ConnectionProfile

Profil koneksi yang akan digunakan.

adapter
NetworkAdapter

Adaptor jaringan tempat koneksi dibagikan. Koneksi bersama akan dikontrol oleh NetworkOperatorTetheringManager.

Mengembalikan

NetworkOperatorTetheringManager

Objek manajer yang dihasilkan.

Atribut
OverloadAttribute

Persyaratan Windows

Rangkaian perangkat
Windows 10 Anniversary Edition (diperkenalkan dalam 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v3.0)
Kemampuan aplikasi
wiFiControl

Keterangan

Dalam rilis sebelumnya, hanya aplikasi istimewa dari operator jaringan yang dapat membuat objek NetworkOperatorTetheringManager dan menggunakannya untuk mengontrol tethering. Dalam rilis ini, aplikasi apa pun dapat membuat objek dengan memanggil CreateFromConnectionProfile. Namun, agar panggilan berhasil, aplikasi harus memiliki kemampuan perangkat kontrol Wi-Fi yang sesuai yang dideklarasikan dalam manifesnya. Contoh berikut menunjukkan bagian dari manifes dengan tag DeviceCapability yang diperlukan, dengan atribut wiFiControl .

<Capabilities>
  <DeviceCapability Name="wiFiControl"/>
</Capabilities>

Jika kemampuan perangkat wiFiControl tidak diatur dalam manifes, maka panggilan ke CreateFromConnectionProfile gagal dengan melemparkan pengecualian.

Kode Anda dapat menentukan apakah kemampuan diatur pada runtime dengan memanggil GetTetheringCapabilityFromConnectionProfile. Jika DisabledBySystemCapability dikembalikan, manifes tidak mengatur kemampuan perangkat yang diperlukan. Perhatikan bahwa meskipun Diaktifkan dikembalikan, kode Anda harus ditulis untuk menangani kesalahan dan pengecualian, karena kemampuan tethering dapat berubah kapan saja, di luar kontrol atau pemberitahuan aplikasi Anda.

Lihat juga

Berlaku untuk