VpnChannel.RequestVpnPacketBuffer(VpnDataPathType, VpnPacketBuffer) Metode

Definisi

Ruang nama:

Windows.Networking.Vpn

Meminta IVpnPacketBuffer dari kumpulan yang ditentukan. Ada satu kumpulan IVpnPacketBuffer untuk jalur kirim dan kumpulan IVpnPacketBuffer lainnya untuk jalur penerima.

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)

Parameter

type

VpnDataPathType

Nilai enum yang menunjukkan kumpulan buffer mana yang akan dipilih buffer. Jika buffer meminta paket dikirim ke server VPN, pilih jenis Kirim enum. Jika buffer yang diminta adalah untuk paket dekapsulasi L3 yang diterima yang siap disuntikkan ke tumpukan jaringan klien, pilih jenis enum Terima.

vpnPacketBuffer

VpnPacketBuffer

Objek IVpnPacketBuffer yang dikembalikan dari kumpulan buffer yang ditentukan.

Persyaratan Windows

Kemampuan aplikasi

networkingVpnProvider

Keterangan

Jika fungsi berhasil, nilai yang dikembalikan S_OK, jika tidak, fungsi akan mengembalikan nilai hresult kesalahan yang menjelaskan kegagalan tertentu. Jika plug-in tidak tersambung, kesalahan akan E_ACCESSDENIED. Jika tidak ada lagi memori yang tersedia, metode akan mengembalikan E_OUTOFMEMORY.

Setiap objek IVpnPacketBuffer yang diminta oleh plugin akhirnya harus dikembalikan ke platform VPN (yaitu melalui IVpnPlugIn.Encapsulate atau IVpnPlugin.Decapsulate). Jika tidak, plugin mungkin tidak dapat meminta buffer baru sampai buffer yang beredar telah dikembalikan.

Catatan

Setiap panggilan ke API ini di luar plug-in VPN yang terhubung akan gagal, karena aktivitas dan interaksi antara plug-in VPN dan sistem dikendalikan oleh profil VPN. Hanya ada satu profil VPN per proses karena plug-in VPN hanya memiliki satu profil VPN yang dipetakan ke dalamnya, dan jika penelepon membuat lebih dari satu objek profil, semuanya akan merujuk ke pengaturan yang sama.

Lihat juga

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