VpnChannel.ActivateForeground(String, ValueSet) 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.
Mengaktifkan aplikasi VPN di latar depan. Ini sering digunakan untuk membiarkan pengguna memasukkan kredensial. Anda dapat memanggil ActivateForeground hanya dari implementasi IVpnPlugin.Connect Anda. 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 Security Assertion Markup Language (SAML) dan autentikasi 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 yang digunakan untuk meneruskan informasi ke aplikasi latar depan. Aplikasi latar depan dapat mengaksesnya dari argumen peristiwa aktivasi.
Mengembalikan
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
Catatan
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 mencakup 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 Lengkapdari ActivationOperation, meneruskan 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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk