VpnChannel.RequestVpnPacketBuffer(VpnDataPathType, VpnPacketBuffer) Metode

Referensi

Definisi

Ruang nama:: Windows.Networking.Vpn

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Edit

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 pengembalian 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.

Nota

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 profil VPN, dan jika pemanggil membuat lebih dari satu objek profil, mereka semua akan merujuk ke pengaturan yang sama.

Berlaku untuk

Lihat juga

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

Bagikan melalui