VpnChannel.Start 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

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.

public:
 virtual void Start(IVectorView<HostName ^> ^ assignedClientIPv4list, IVectorView<HostName ^> ^ assignedClientIPv6list, VpnInterfaceId ^ vpnInterfaceId, VpnRouteAssignment ^ routeScope, VpnNamespaceAssignment ^ namespaceScope, unsigned int mtuSize, unsigned int maxFrameSize, bool optimizeForLowCostNetwork, Platform::Object ^ mainOuterTunnelTransport, Platform::Object ^ optionalOuterTunnelTransport) = Start;

/// [Windows.Foundation.Metadata.Overload("Start")]
void Start(IVectorView<HostName> const& assignedClientIPv4list, IVectorView<HostName> const& assignedClientIPv6list, VpnInterfaceId const& vpnInterfaceId, VpnRouteAssignment const& routeScope, VpnNamespaceAssignment const& namespaceScope, uint32_t const& mtuSize, uint32_t const& maxFrameSize, bool const& optimizeForLowCostNetwork, IInspectable const& mainOuterTunnelTransport, IInspectable const& optionalOuterTunnelTransport);

[Windows.Foundation.Metadata.Overload("Start")]
public void Start(IReadOnlyList<HostName> assignedClientIPv4list, IReadOnlyList<HostName> assignedClientIPv6list, VpnInterfaceId vpnInterfaceId, VpnRouteAssignment routeScope, VpnNamespaceAssignment namespaceScope, uint mtuSize, uint maxFrameSize, bool optimizeForLowCostNetwork, object mainOuterTunnelTransport, object optionalOuterTunnelTransport);

function start(assignedClientIPv4list, assignedClientIPv6list, vpnInterfaceId, routeScope, namespaceScope, mtuSize, maxFrameSize, optimizeForLowCostNetwork, mainOuterTunnelTransport, optionalOuterTunnelTransport)

Public Sub Start (assignedClientIPv4list As IReadOnlyList(Of HostName), assignedClientIPv6list As IReadOnlyList(Of HostName), vpnInterfaceId As VpnInterfaceId, routeScope As VpnRouteAssignment, namespaceScope As VpnNamespaceAssignment, mtuSize As UInteger, maxFrameSize As UInteger, optimizeForLowCostNetwork As Boolean, mainOuterTunnelTransport As Object, optionalOuterTunnelTransport As Object)

Parameter

assignedClientIPv4list: IVectorView<HostName>

IReadOnlyList<HostName>

Pointer ke IVectorView< Windows.Networking.HostName *> vektor yang menentukan alamat IPv4 yang ditetapkan oleh server VPN ke klien VPN. Alamat harus diatur pada antarmuka VPN L3. Jika null, DHCPv4 digunakan.

assignedClientIPv6list: IVectorView<HostName>

IReadOnlyList<HostName>

Penunjuk ke struktur Windows.Networking.HostName yang menentukan alamat IPv6 yang ditetapkan oleh server VPN ke klien VPN, dan yang harus diatur pada antarmuka VPN L3. Jika null, DHCPv6 atau RD digunakan.

vpnInterfaceId: VpnInterfaceId

Penunjuk ke VpnInterfaceId.

routeScope: VpnRouteAssignment

Penunjuk ke kelas Windows.Networking.VpnRouteAssignment yang mewakili rute yang harus dikaitkan / tidak terkait dengan antarmuka VPN

namespaceScope: VpnNamespaceAssignment

Penunjuk ke kelas Windows.Networking.DomainNameAssignment yang mewakili daftar awalan nama yang terkait dengan saluran VPN, termasuk dns dan server proksinya.

mtuSize: UInt32
unsigned int

uint32_t

Nilai UINT16 yang menentukan ukuran MTU antarmuka jaringan VPN L3. Ini juga merupakan ukuran IVpnPacketBuffers di kumpulan Terima. Nilai ini harus dikonfigurasi menjadi paling banyak 1400.

maxFrameSize: UInt32
unsigned int

uint32_t

Nilai UINT16 yang menentukan ukuran maksimum bingkai yang ditentukan oleh enkapsulasi protokol VPN tanpa menghitung outerTunnelTransport. Ini juga merupakan ukuran IVpnPacketBuffers di kumpulan Kirim. Nilai ini harus dikonfigurasi sebagai mtuSize + [ukuran header enkapsulasi], dan harus <=1500. Jika akan lebih besar dari 1500 ukuran header mtuSize atau enkapsulasi harus dikurangi karena platform membatasi ukuran bingkai menjadi 1500.

optimizeForLowCostNetwork: Boolean
bool

Boolean menentukan apakah kerangka kerja VPN harus memantau dan menggunakan jaringan berbilai rendah saat tersedia. Jika TRUE kerangka kerja VPN akan memanggil panggilan balik connect() ke plug-in VPN untuk menyambungkannya kembali setiap kali jaringan lama dikenai biaya dan jaringan biaya rendah baru tersedia.

mainOuterTunnelTransport: Object
Platform::Object

IInspectable

Objek yang dapat dipilih IInspectable untuk transportasi soket. Objek ini bisa menjadi Windows.Networking.Sockets.DatagramSocket atau Windows.Networking.Sockets.StreamSocket. Soket ini mengontrol koneksi ke server VPN dan akan digunakan untuk mengirim paket IP yang dienkapsulasi dan menerima data yang dienkapsulasi.

optionalOuterTunnelTransport: Object
Platform::Object

IInspectable

Objek IInspectable opsional untuk transportasi soket. Objek ini bisa menjadi Windows.Networking.Sockets.DatagramSocket atau Windows.Networking.Sockets.StreamSocket. Soket ini mengontrol koneksi ke server VPN dan akan digunakan untuk mengirim paket IP yang dienkapsulasi dan menerima data yang dienkapsulasi.

Atribut: OverloadAttribute

Persyaratan Windows

Kemampuan aplikasi

networkingVpnProvider

Keterangan

Jika fungsi berhasil, nilai pengembalian S_OK, jika tidak, fungsi akan mengembalikan nilai hresult kesalahan yang menjelaskan kegagalan tertentu. Jika plug-in tidak tersambung, kesalahan akan E_ACCESSDENIED.

Nota

Setiap panggilan ke API ini di luar plug-in VPN yang terhubung akan gagal, karena aktivitas dan interaksi antara plug-in VPN dan sistem dikendalikan oleh profil VPN. Hanya ada satu profil VPN per proses karena plug-in VPN hanya memiliki satu profil VPN yang dipetakan ke profil VPN, dan jika pemanggil membuat lebih dari satu objek profil, mereka semua akan merujuk ke pengaturan yang sama.

Pada keberhasilan kepemilikan outertTunnelTransport ditransfer oleh kerangka kerja VPN. Memanggil metode ini beberapa kali dengan parameter yang sama tidak akan berpengaruh. Memanggil metode ini beberapa kali dengan variasi dalam nilai parameter akan memastikan saluran diperbarui dengan nilai terbaru tanpa gangguan pada properti lain.

Hanya ada satu saluran VPN per proses dan karenanya plug-in VPN hanya dapat memiliki satu saluran VPN yang ditetapkan untuk itu. mtuSize harus selalu lebih kecil dari maxFrameSize .

Berlaku untuk

Bagikan melalui