VpnHood.Net.VpnAdapters.WindowsVpnPlugin 9.1.875

dotnet add package VpnHood.Net.VpnAdapters.WindowsVpnPlugin --version 9.1.875
                    
NuGet\Install-Package VpnHood.Net.VpnAdapters.WindowsVpnPlugin -Version 9.1.875
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="VpnHood.Net.VpnAdapters.WindowsVpnPlugin" Version="9.1.875" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="VpnHood.Net.VpnAdapters.WindowsVpnPlugin" Version="9.1.875" />
                    
Directory.Packages.props
<PackageReference Include="VpnHood.Net.VpnAdapters.WindowsVpnPlugin" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add VpnHood.Net.VpnAdapters.WindowsVpnPlugin --version 9.1.875
                    
#r "nuget: VpnHood.Net.VpnAdapters.WindowsVpnPlugin, 9.1.875"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package VpnHood.Net.VpnAdapters.WindowsVpnPlugin@9.1.875
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=VpnHood.Net.VpnAdapters.WindowsVpnPlugin&version=9.1.875
                    
Install as a Cake Addin
#tool nuget:?package=VpnHood.Net.VpnAdapters.WindowsVpnPlugin&version=9.1.875
                    
Install as a Cake Tool

VpnHood.Net.VpnAdapters.WindowsVpnPlugin

The VPN adapter of VpnHood for a Windows VPN plug-in: a packaged app's VPN, which Windows lists in its VPN settings and runs over a VpnChannel of Windows.Networking.Vpn. It implements VpnHood.Net.VpnAdapters.Abstractions.

dotnet add package VpnHood.Net.VpnAdapters.WindowsVpnPlugin

How it works

  • WindowsVpnPluginAdapter is an IVpnAdapter: make it in the plug-in's Connect with the VpnChannel Windows gave it, and use it as the Abstractions quick start uses NullVpnAdapter, with the VPN server's address in the options' ServerIp, which the channel's transport needs. Windows wants the channel started before Connect returns, so wait there for StartedTask, which completes once it has.
  • Windows freezes the plug-in's process between VPN events; VpnHood's host keeps it running with a connection from its app to the package's app service.
  • Windows owns the interface: a start gathers the addresses, routes, DNS servers and MTU, and the adapter starts the channel with them. Its MTU is at most 1,400 bytes. There is no NAT and no app filter.
  • Pass the plug-in's Encapsulate callback to OnEncapsulate: the adapter reads the device's packets from there, and leaves their buffers to Windows. It writes incoming packets into the channel's receive buffers, so the plug-in's Decapsulate has nothing to do.
  • A close leaves the channel up: stop it in the plug-in's Disconnect, as Windows takes a channel stopped by itself for a dropped connection and dials again.

Requirements

  • Windows 11 or later.
  • A packaged app with the networkingVpnProvider capability and a vpnClient background task, whose IVpnPlugIn runs the adapter, and a VPN profile of the app for Windows to connect.

License

LGPL-2.1-only. See the VpnHood repository.

Product Compatible and additional computed target framework versions.
.NET net11.0-windows10.0.26100 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on VpnHood.Net.VpnAdapters.WindowsVpnPlugin:

Package Downloads
VpnHood.Core.Client.VpnServices.Host.WindowsVpnPlugin

VpnHood's VPN service as the Windows VPN plug-in: the C#/WinRT component Windows activates and calls in the VPN host, and the service it runs

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
9.1.875 0 11/16/2026
9.1.874 36 11/15/2026
9.1.864 117 11/3/2026
9.0.860 129 10/31/2026
9.0.859.16-prerelease 116 10/30/2026