VpnChannel.ActivateForeground(String, ValueSet) Metode

Referensi

Definisi

Ruang nama:: Windows.Networking.Vpn

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

Mengaktifkan aplikasi VPN di latar depan. Ini sering digunakan untuk membiarkan pengguna memasukkan kredensial. Anda dapat memanggil ActivateForeground hanya dari implementasi IVpnPlugin.Connect. Saat aplikasi berada di latar depan, batas waktu Connect reguler dijeda.

Panggilan ActivateForeground akan dibatalkan jika ada jeda panjang (sekitar 10 menit). Jika tidak dapat diluncurkan, maka plugin idealnya harus mendukung metode autentikasi yang tidak memerlukan antarmuka pengguna (UI).

Dimaksudkan untuk mendukung skema autentikasi berbasis web seperti autentikasi Security Assertion Markup Language (SAML) dan Azure Active Directory (AAD).

public:
 virtual ValueSet ^ ActivateForeground(Platform::String ^ packageRelativeAppId, ValueSet ^ sharedContext) = ActivateForeground;

ValueSet ActivateForeground(winrt::hstring const& packageRelativeAppId, ValueSet const& sharedContext);

public ValueSet ActivateForeground(string packageRelativeAppId, ValueSet sharedContext);

function activateForeground(packageRelativeAppId, sharedContext)

Public Function ActivateForeground (packageRelativeAppId As String, sharedContext As ValueSet) As ValueSet

Parameter

packageRelativeAppId: String
Platform::String

winrt::hstring

String yang berisi pengidentifikasi aplikasi relatif paket (PRAID) dari aplikasi latar depan untuk diluncurkan.

sharedContext: ValueSet

Objek ValueSet digunakan untuk meneruskan informasi ke aplikasi latar depan. Aplikasi latar depan dapat mengaksesnya dari argumen peristiwa aktivasi.

Mengembalikan

ValueSet

Objek ValueSet yang berisi objek Windows Runtime pilihan Anda yang diteruskan kembali dari aplikasi latar depan ke plugin VPN, menunjukkan hasil permintaan latar depan.

Persyaratan Windows

Rangkaian perangkat	Windows 11 (diperkenalkan dalam 10.0.22000.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v14.0)
Kemampuan aplikasi	networkingVpnProvider

Keterangan

Nota

Memanggil API ini di luar implementasi metode IVpnPlugin.Connect dalam plug-in VPN akan gagal.

Menggunakan mekanisme aktivasi latar depan memerlukan penanganan aktivasi di beberapa tempat.

Dalam metode IVpnPlugin.Connect, Anda akan memanggil ActivateForeground dengan pengidentifikasi aplikasi relatif paket (PRAID) yang benar, dan ValueSet yang berisi semua nilai yang ingin Anda kirim ke aplikasi latar depan Anda.

Di aplikasi latar depan, Anda perlu menangkap aktivasi. Aplikasi latar depan akan diaktifkan dengan nilai Windows.ApplicationModel.ActivationKindVpnForeground. Argumen aktivasi akan berjenis Windows.Networking.Vpn.VpnForegroundActivatedEventArgs, dan akan menyertakan tiga bidang.

ProfileName (String).
SharedContext (ValueSet).
ActivationOperation (Windows.Networking.Vpn.VpnForegroundActivationOperation.

Aplikasi latar depan kemudian dapat menyiapkan antarmuka pengguna (UI) aplikasi Anda untuk menangani otorisasi yang diperlukan (atau data apa pun yang diperlukan). Setelah selesai, Anda harus memanggil metode Lengkap dariAktivasi , melewati ValueSet nilai yang ingin Anda kembalikan ke panggilan IVpnPlugin.Connect.

Kembali ke panggilan IVpnPlugin.Connect, gunakan ValueSet yang dikembalikan dari ActivateForeground untuk memutuskan apakah autentikasi berhasil, dan menangani kesalahan apa pun.

Berlaku untuk

Bagikan melalui