VpnChannel.RequestVpnPacketBuffer(VpnDataPathType, VpnPacketBuffer) Método

Definición

Espacio de nombres:

Windows.Networking.Vpn

Solicita un IVpnPacketBuffer desde el grupo especificado. Hay un grupo de IVpnPacketBuffer para la ruta de acceso de envío y otro grupo de IVpnPacketBuffer para la ruta de acceso de recepción.

public:
 virtual void RequestVpnPacketBuffer(VpnDataPathType type, [Out] VpnPacketBuffer ^ & vpnPacketBuffer) = RequestVpnPacketBuffer;

void RequestVpnPacketBuffer(VpnDataPathType const& type, [Out] VpnPacketBuffer const& & vpnPacketBuffer);

public void RequestVpnPacketBuffer(VpnDataPathType type, out VpnPacketBuffer vpnPacketBuffer);

Public Sub RequestVpnPacketBuffer (type As VpnDataPathType, ByRef vpnPacketBuffer As VpnPacketBuffer)

Parámetros

type

VpnDataPathType

Valor de enumeración que indica del grupo de búferes del que se va a seleccionar un búfer. Si el búfer solicitó que el paquete se envíe al servidor VPN, elija el tipo de enumeración Enviar. Si el búfer solicitado es para un paquete L3 descapsulado recibido listo para insertarse en la pila de red cliente, elija el tipo de enumeración Receive.

vpnPacketBuffer

VpnPacketBuffer

Objeto IVpnPacketBuffer devuelto por el grupo de búferes especificado.

Requisitos de Windows

Características de aplicaciones

networkingVpnProvider

Comentarios

Si la función se ejecuta correctamente, el valor devuelto es S_OK; de lo contrario, la función devolverá un valor hresult de error que describe el error específico. Si el complemento no está conectado, el error se E_ACCESSDENIED. Si no hay más memoria disponible, el método devolverá E_OUTOFMEMORY.

Cualquier objeto IVpnPacketBuffer solicitado por el complemento debe devolverse finalmente a la plataforma VPN (es decir, a través de IVpnPlugIn.Encapsulate o IVpnPlugin.Decapsulate). De lo contrario, es posible que el complemento no pueda solicitar nuevos búferes hasta que se hayan devuelto los búferes pendientes.

Nota

Cualquier llamada a esta API fuera de un complemento VPN conectado producirá un error, ya que el perfil de VPN controla la actividad y las interacciones entre el complemento VPN y el sistema. Solo puede haber un perfil de VPN por proceso porque el complemento vpn solo tiene asignado un perfil de VPN y, si un autor de la llamada fuera a crear más de un objeto de perfil, todos harían referencia a la misma configuración.

Consulte también

• <xref:Windows.Networking.Vpn.VpnChannel.GetVpnSendPacketBuffer+or+a+receive+path+buffer+via+M%3aWindows.Networking.Vpn.VpnChannel.GetVpnReceivePacketBuffer.>