VpnChannel.RequestVpnPacketBuffer(VpnDataPathType, VpnPacketBuffer) Méthode

  • Référence

Définition

Espace de noms:
Windows.Networking.Vpn
Modifier

Demande une IVpnPacketBuffer à partir du pool spécifié. Il existe un pool IVpnPacketBuffer pour le chemin d’envoi et un autre IVpnPacketBuffer pool pour le chemin de réception.

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)

Paramètres

type
VpnDataPathType

Valeur d’énumération indiquant le pool de mémoires tampons à partir duquel choisir une mémoire tampon. Si la mémoire tampon demandée pour que le paquet soit envoyé au serveur VPN, sélectionnez le type d’énumération d’envoi. Si la mémoire tampon demandée concerne un paquet L3 reçu prêt à être injecté dans la pile réseau cliente, sélectionnez le type d’énumération de réception.

vpnPacketBuffer
VpnPacketBuffer

Objet IVpnPacketBuffer retourné par le pool de mémoires tampons spécifié.

Configuration requise pour Windows

Fonctionnalités de l’application
networkingVpnProvider

Remarques

Si la fonction réussit, la valeur de retour est S_OK; sinon, la fonction retourne une valeur hresult d’erreur décrivant l’échec spécifique. Si le plug-in n’est pas connecté, l’erreur est E_ACCESSDENIED. S’il n’y a plus de mémoire disponible, la méthode retourne E_OUTOFMEMORY.

Tout objet IVpnPacketBuffer demandé par le plug-in doit éventuellement être retourné à la plateforme VPN (c’est-à-dire via IVpnPlugIn.Encapsuler ou IVpnPlugin.Decapsulate). Sinon, le plug-in ne peut pas demander de nouvelles mémoires tampons tant que les mémoires tampons en attente n’ont pas été retournées.

Note

Tout appel à cette API en dehors d’un plug-in VPN connecté échoue, car l’activité et les interactions entre le plug-in VPN et le système sont contrôlées par le profil VPN. Il ne peut y avoir qu’un seul profil VPN par processus, car le plug-in VPN n’a qu’un seul profil VPN mappé à celui-ci et si un appelant devait créer plusieurs objets de profil, ils font tous référence aux mêmes paramètres.

S’applique à

Voir aussi

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