Bagikan melalui


VpnChannel.ActivateForeground(String, ValueSet) Metode

Definisi

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.

  1. ProfileName (String).
  2. SharedContext (ValueSet).
  3. 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