HotspotAuthenticationContext.IssueCredentialsAsync Metode

Referensi

Definisi

Ruang nama:: Windows.Networking.NetworkOperators

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.

Edit

Secara asinkron menyediakan kredensial ke Windows untuk autentikasi hotspot Windows tidak menyimpan kredensial ini dan peristiwa autentikasi lain akan dinaikkan ketika sistem tersambung ke hotspot yang sama lagi.

Ini adalah versi asinkron dari IssueCredentials. Dibutuhkan parameter yang sama, tetapi operasi asinkron hanya selesai ketika autentikasi selesai. Sebaliknya, ISSUECredentials API kembali segera setelah autentikasi dimulai. Setelah menyelesaikan metode ini, objek hasil dapat diperiksa untuk memeriksa status upaya autentikasi.

Catatan

Fungsionalitas ini hanya tersedia untuk aplikasi operator seluler dan aplikasi UWP yang diberikan akses istimewa oleh operator jaringan seluler.

Jika Anda ingin menggunakan API ini dan menerbitkan aplikasi anda ke Microsoft Store, maka Anda akan memerlukan persetujuan khusus. Untuk informasi selengkapnya, lihat bagian Kemampuan terbatas dalam topik Deklarasi kemampuan aplikasi .

public:
 virtual IAsyncOperation<HotspotCredentialsAuthenticationResult ^> ^ IssueCredentialsAsync(Platform::String ^ userName, Platform::String ^ password, Platform::String ^ extraParameters, bool markAsManualConnectOnFailure) = IssueCredentialsAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<HotspotCredentialsAuthenticationResult> IssueCredentialsAsync(winrt::hstring const& userName, winrt::hstring const& password, winrt::hstring const& extraParameters, bool const& markAsManualConnectOnFailure);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<HotspotCredentialsAuthenticationResult> IssueCredentialsAsync(string userName, string password, string extraParameters, bool markAsManualConnectOnFailure);

function issueCredentialsAsync(userName, password, extraParameters, markAsManualConnectOnFailure)

Public Function IssueCredentialsAsync (userName As String, password As String, extraParameters As String, markAsManualConnectOnFailure As Boolean) As IAsyncOperation(Of HotspotCredentialsAuthenticationResult)

Parameter

userName: String
Platform::String

winrt::hstring

Parameter UserName dari protokol autentikasi roaming Penyedia Layanan Internet Nirkabel (WISPr). IssueCredentials melakukan pengodean URL sebelum mengirimkan nilai ke server. Jika string ini kosong, parameter autentikasi yang sesuai akan dilewati.

password: String
Platform::String

winrt::hstring

Parameter Kata Sandi dari protokol autentikasi WISPr. IssueCredentials melakukan pengodean URL sebelum mengirimkan nilai ke server. Jika string ini kosong, parameter autentikasi yang sesuai akan dilewati.

extraParameters: String
Platform::String

winrt::hstring

Parameter tambahan yang akan ditambahkan ke string autentikasi. IssueCredentials menambahkan parameter ini setelah karakter "&" ke string HTTP POST apa adanya tanpa pengodean apa pun. Ini dapat digunakan untuk menambahkan beberapa parameter. Default untuk parameter ini adalah string kosong.

markAsManualConnectOnFailure: Boolean
bool

Jika true, aplikasi akan menonaktifkan properti sambungkan otomatis secara permanen pada koneksi. Jika autentikasi gagal, koneksi akan terputus dan tidak dicoba kembali di sesi pengguna saat ini. Jika tidak, salah.