IVpnPlugIn.Encapsulate(VpnChannel, VpnPacketBufferList, VpnPacketBufferList) IVpnPlugIn.Encapsulate(VpnChannel, VpnPacketBufferList, VpnPacketBufferList) IVpnPlugIn.Encapsulate(VpnChannel, VpnPacketBufferList, VpnPacketBufferList) IVpnPlugIn.Encapsulate(VpnChannel, VpnPacketBufferList, VpnPacketBufferList) IVpnPlugIn.Encapsulate(VpnChannel, VpnPacketBufferList, VpnPacketBufferList) Method

Definition

This method instructs the VPN plug-in to prepare the indicated L3 IP packet for transmission to the VPN server. The process might include any encapsulation specific to the VPN protocol.

public : void Encapsulate(VpnChannel channel, VpnPacketBufferList packets, VpnPacketBufferList encapulatedPackets)
void Encapsulate(VpnChannel channel, VpnPacketBufferList packets, VpnPacketBufferList encapulatedPackets) const;
public void Encapsulate(VpnChannel channel, VpnPacketBufferList packets, VpnPacketBufferList encapulatedPackets)
Public Sub Encapsulate(channel As VpnChannel, packets As VpnPacketBufferList, encapulatedPackets As VpnPacketBufferList)
iVpnPlugIn.encapsulate(channel, packets, encapulatedPackets);

Parameters

channel
VpnChannel VpnChannel VpnChannel

The VPN channel object representing the instance VPN connection of the VPN plug-in to the VPN server.

packets
VpnPacketBufferList VpnPacketBufferList VpnPacketBufferList

An L3 IP packets originated by the client machine TCP/IP stack and that needs to be processed to be sent to the corporate network.

encapulatedPackets
VpnPacketBufferList VpnPacketBufferList VpnPacketBufferList

An buffer containing an encapsulated IP packet (framed in a specific VPN protocol message and or potentially encrypted) that is ready to be sent to the VPN server through the outerTunnelTransport.

Additional features and requirements

Capabilities
networkingVpnProvider

Remarks

If an error occurs the packets will simply be dropped. It is required that any IVpnPacketBuffer object, either passed to the method in the packets parameter or requested by the plugin, be returned to the VPN framework. The VPN framework will then send the IVpnPacketBuffer objects in encapulatedPackets via one of the transports specified during Connect and will clean up the remaining IVpnPacketBuffer objects in packets.