VpnChannel Kelas
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.
Menyediakan metode untuk membuat dan menghancurkan saluran VPN, dan metode untuk melakukan manajemen buffer. Saluran VPN adalah objek dalam sistem yang menautkan aliran data lalu lintas jaringan antara soket server VPN plug-in VPN dan tumpukan jaringan komputer klien.
public ref class VpnChannel sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
class VpnChannel final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
public sealed class VpnChannel
Public NotInheritable Class VpnChannel
- Warisan
- Atribut
Persyaratan Windows
Rangkaian perangkat |
Windows 10 (diperkenalkan dalam 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)
|
Kemampuan aplikasi |
networkingVpnProvider
|
Keterangan
Riwayat versi
Versi Windows | Versi SDK | Nilai ditambahkan |
---|---|---|
1803 | 17134 | AddAndAssociateTransport |
1803 | 17134 | CurrentRequestTransportContext |
1803 | 17134 | GetSlotTypeForTransportContext |
1803 | 17134 | ReplaceAndAssociateTransport |
1803 | 17134 | StartReconnectingTransport |
1803 | 17134 | StartWithTrafficFilter(IEnumerable<HostName>, IEnumerable<HostName>, VpnInterfaceId,VpnRouteAssignment,VpnDomainNameAssignment,UInt32,UInt32,Boolean,IEnumerableIEnumerable<Object>,VpnTrafficFilterAssignment) |
Properti
Configuration |
Mendapatkan atau mengatur objek VpnChannelConfiguration |
CurrentRequestTransportContext |
Mendapatkan objek konteks transportasi yang digunakan, misalnya nama host atau server. |
Id |
Mendapatkan ID instans unik saluran VPN. Ini dapat digunakan untuk menyederhanakan operasi demuxing antara dua instans koneksi VPN. |
PlugInContext |
Mendapatkan atau mengatur objek konteks yang dapat digunakan plug-in VPN untuk mengaitkan status internal mereka dengan objek VpnChannel |
SystemHealth |
Mendapatkan pernyataan kesehatan komputer klien. |
Metode
ActivateForeground(String, ValueSet) |
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 Dimaksudkan untuk mendukung skema autentikasi berbasis web seperti autentikasi Security Assertion Markup Language (SAML) dan Azure Active Directory (AAD). |
AddAndAssociateTransport(Object, Object) |
Menyiapkan, menandai, dan membuat transportasi untuk digunakan oleh kerangka kerja VPN sebagai tautan transportasi yang mengomunikasikan plug-in VPN ke server VPN. Panggilan ini harus dilakukan sebelum operasi lain yang terkait dengan API kerangka kerja VPN. |
AppendVpnReceivePacketBuffer(VpnPacketBuffer) |
Menambahkan objek VpnPacketBuffer |
AppendVpnSendPacketBuffer(VpnPacketBuffer) |
Menambahkan objek kirim |
AssociateTransport(Object, Object) |
Menyiapkan dan menandai transportasi untuk digunakan oleh kerangka kerja VPN sebagai tautan transportasi yang mengomunikasikan plug-in VPN ke server VPN. Panggilan ini harus dilakukan sebelum operasi lain yang terkait dengan API kerangka kerja VPN. |
FlushVpnReceivePacketBuffers() |
Bersihkan buffer paket penerima yang ditambahkan. Lihat AppendVpnReceivePacketBuffer. |
FlushVpnSendPacketBuffers() |
Bersihkan buffer paket kirim tambahan apa pun. Lihat AppendVpnSendPacketBuffer. |
GetSlotTypeForTransportContext(Object) |
Mengambil jenis slot (perangkat keras atau perangkat lunak) untuk objek konteks transportasi yang ditentukan. |
GetVpnReceivePacketBuffer() |
Meminta objek VpnPacketBuffer |
GetVpnSendPacketBuffer() |
Mengambil objek VpnPacketBuffer dari kumpulan buffer paket kirim untuk digunakan dalam enkapsulasi dan transmisi paket data dari tumpukan jaringan klien ke server VPN. |
LogDiagnosticMessage(String) |
Menulis pesan diagnostik ke log sistem. |
ProcessEventAsync(Object, Object) |
Memproses peristiwa VpnChannel yang tertunda. |
ReplaceAndAssociateTransport(Object, Object) |
Mengganti transportasi yang ada dengan yang baru untuk digunakan oleh kerangka kerja VPN sebagai tautan transportasi yang mengomunikasikan plug-in VPN ke server VPN. |
RequestCredentials(VpnCredentialType, Boolean, Boolean, Certificate) |
Minta platform VPN untuk mengumpulkan kredensial dari pengguna. Plug-in dapat menentukan jenis dan bentuk kredensial yang akan dikumpulkan. Hasilnya adalah objek yang berisi kredensial utama tergantung pada jenis dan kredensial sekunder untuk kasus perubahan dan kedaluwarsa. |
RequestCredentialsAsync(VpnCredentialType) |
Meminta platform VPN untuk mengumpulkan kredensial dari jenis kredensial tertentu dari pengguna. |
RequestCredentialsAsync(VpnCredentialType, UInt32) |
Meminta platform VPN untuk mengumpulkan kredensial dari pengguna. Plug-in dapat menentukan jenis dan bentuk kredensial yang akan dikumpulkan. Hasilnya adalah objek yang berisi kredensial utama tergantung pada jenisnya, dan kredensial sekunder untuk kasus perubahan dan kedaluwarsa. |
RequestCredentialsAsync(VpnCredentialType, UInt32, Certificate) |
Platform VPN untuk mengumpulkan kredensial dari pengguna. Jika interaksi pengguna diperlukan untuk mendapatkan kredensial atau persetujuan, platform menyediakan interaksi pengguna yang diperlukan. Plug-in VPN harus meminta kredensial sebelum menggunakan semua jenis kredensial, bahkan jika niatnya adalah untuk tidak memanggil interaksi pengguna untuk itu. |
RequestCustomPrompt(IVectorView<IVpnCustomPrompt>) |
Tidak didukung. |
RequestCustomPromptAsync(IVectorView<IVpnCustomPromptElement>) |
Meminta informasi dari pengguna dengan menyajikan permintaan. Memungkinkan penggunaan elemen prompt yang dapat dicampur untuk membuat permintaan penuh kepada pengguna. Input yang disediakan oleh pengguna dikembalikan ke pemanggil dalam objek yang ditentukan. |
RequestVpnPacketBuffer(VpnDataPathType, VpnPacketBuffer) |
Meminta IVpnPacketBuffer |
SetAllowedSslTlsVersions(Object, Boolean) |
Tidak didukung. |
SetErrorMessage(String) |
Tidak didukung. |
Start(IVectorView<HostName>, IVectorView<HostName>, VpnInterfaceId, VpnRouteAssignment, VpnNamespaceAssignment, UInt32, UInt32, Boolean, Object, Object) |
Membuat saluran VPN yang akan digunakan oleh plug-in VPN. Ini juga membuat antarmuka jaringan L3 untuk aplikasi di komputer klien untuk dapat melihat jaringan perusahaan. |
StartExistingTransports(IVectorView<HostName>, IVectorView<HostName>, VpnInterfaceId, VpnRouteAssignment, VpnDomainNameAssignment, UInt32, UInt32, Boolean) |
Membuat saluran VPN yang akan digunakan oleh plug-in VPN. Ini juga membuat antarmuka jaringan L3 untuk aplikasi di komputer klien untuk dapat melihat jaringan perusahaan. |
StartReconnectingTransport(Object, Object) |
Sambungkan kembali transportasi soket. Konteks transportasi dan transportasi adalah satu-satunya parameter yang dapat diubah pada koneksi ulang transportasi soket. Penting API ini tidak diimplementasikan, dan kami sarankan Anda tidak menyebutnya. |
StartWithMainTransport(IVectorView<HostName>, IVectorView<HostName>, VpnInterfaceId, VpnRouteAssignment, VpnDomainNameAssignment, UInt32, UInt32, Boolean, Object) |
Membuat saluran VPN yang akan digunakan oleh plug-in VPN. Ini juga membuat antarmuka jaringan L3 untuk aplikasi di komputer klien untuk dapat melihat jaringan perusahaan. |
StartWithTrafficFilter(IIterable<HostName>, IIterable<HostName>, VpnInterfaceId, VpnRouteAssignment, VpnDomainNameAssignment, UInt32, UInt32, Boolean, IIterable<Object>, VpnTrafficFilterAssignment) |
Membuat saluran VPN untuk jumlah transportasi arbitrer yang akan digunakan oleh plug-in VPN. Ini juga membuat antarmuka jaringan L3 untuk aplikasi di komputer klien untuk dapat melihat jaringan perusahaan. Ini memungkinkan spesifikasi filter lalu lintas untuk digunakan dalam skenario VPN per aplikasi. |
StartWithTrafficFilter(IVectorView<HostName>, IVectorView<HostName>, VpnInterfaceId, VpnRouteAssignment, VpnDomainNameAssignment, UInt32, UInt32, Boolean, Object, Object, VpnTrafficFilterAssignment) |
Membuat saluran VPN yang akan digunakan oleh plug-in VPN. Ini juga membuat antarmuka jaringan L3 untuk aplikasi di komputer klien untuk dapat melihat jaringan perusahaan. Ini memungkinkan spesifikasi filter lalu lintas untuk digunakan dalam skenario VPN per aplikasi. |
Stop() |
Menghancurkan objek saluran VPN yang dibuat sebelumnya. Memisahkan dan menutup koneksi outerTunnelTransport |
TerminateConnection(String) |
Memungkinkan plugin VPN untuk menunjukkan pesan kesalahan dan mengakhiri upaya koneksi yang dilakukan di dalam metode IVpnPlugin.Connect. Tidak boleh dipanggil pada kasus koneksi ulang. |
Acara
ActivityChange |
Tidak didukung. |
ActivityStateChange |
Peristiwa muncul saat status aktivitas saluran telah berubah. Digunakan oleh plug-in VPN untuk menentukan apakah saluran aktif dengan lalu lintas atau diam. |