VpnChannel.RequestVpnPacketBuffer(VpnDataPathType, VpnPacketBuffer) Metodo

Riferimento

Definizione

Spazio dei nomi:: Windows.Networking.Vpn

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Richiede un IVpnPacketBuffer dal pool specificato. Esiste un pool di IVpnPacketBuffer per il percorso di invio e un altro pool di IVpnPacketBuffer per il percorso di ricezione.

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)

Parametri

type: VpnDataPathType

Valore di enumerazione che indica il pool di buffer da cui selezionare un buffer. Se il buffer ha richiesto l'invio del pacchetto al server VPN, selezionare il tipo di enumerazione Invia. Se il buffer richiesto è per un pacchetto decapsulato L3 ricevuto pronto per l'inserimento nello stack di rete client, selezionare il tipo di enumerazione Ricezione.

vpnPacketBuffer: VpnPacketBuffer

Oggetto IVpnPacketBuffer restituito dal pool di buffer specificato.

Requisiti Windows

Funzionalità dell'app

networkingVpnProvider

Commenti

Se la funzione ha esito positivo, il valore restituito è S_OK, in caso contrario la funzione restituirà un valore hresult di errore che descrive l'errore specifico. Se il plug-in non è connesso, l'errore verrà E_ACCESSDENIED. Se non è disponibile più memoria, il metodo restituirà E_OUTOFMEMORY.

Qualsiasi IVpnPacketBuffer oggetto richiesto dal plug-in deve essere restituito alla piattaforma VPN (ad esempio tramite IVpnPlugIn.Encapsulate o IVpnPlugin.Decapsulate). In caso contrario, il plug-in potrebbe non essere in grado di richiedere nuovi buffer fino a quando non vengono restituiti i buffer in sospeso.

Nota

Qualsiasi chiamata a questa API all'esterno di un plug-in VPN connesso avrà esito negativo, perché l'attività e le interazioni tra il plug-in VPN e il sistema sono controllati dal profilo VPN. Può esserci un solo profilo VPN per processo perché il plug-in VPN ha solo un profilo VPN mappato e, se un chiamante dovesse creare più di un oggetto profilo, tutti fanno riferimento alle stesse impostazioni.

Si applica a

Vedi anche

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

Condividi tramite