VpnChannel.RequestVpnPacketBuffer(VpnDataPathType, VpnPacketBuffer) 메서드

정의

네임스페이스:

Windows.Networking.Vpn

지정된 풀에서 IVpnPacketBuffer 요청합니다. 송신 경로에 대한 IVpnPacketBuffer 풀과 수신 경로에 대한 다른 IVpnPacketBuffer 풀이 있습니다.

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)

매개 변수

type

VpnDataPathType

버퍼를 선택할 버퍼 풀을 나타내는 열거형 값입니다. 버퍼가 VPN 서버로 패킷을 보내도록 요청한 경우 보내기 열거형 유형을 선택합니다. 클라이언트 네트워크 스택에 삽입할 준비가 된 수신된 L3 캡슐화된 패킷에 대해 요청된 버퍼인 경우 수신 열거형 유형을 선택합니다.

vpnPacketBuffer

VpnPacketBuffer

지정된 버퍼 풀에서 반환된 IVpnPacketBuffer 개체입니다.

Windows 요구 사항

앱 기능	networkingVpnProvider

설명

함수가 성공하면 반환 값이 S_OK, 그렇지 않으면 함수는 특정 오류를 설명하는 오류 hresult 값을 반환합니다. 플러그 인이 연결되어 있지 않으면 오류가 E_ACCESSDENIED. 사용 가능한 메모리가 더 이상 없으면 메서드는 E_OUTOFMEMORY반환합니다.

플러그 인에서 요청한 모든 IVpnPacketBuffer 개체는 결국 VPN 플랫폼으로 반환되어야 합니다(즉, IVpnPlugIn.Encapsulate 또는 IVpnPlugin.Decapsulate통해). 그렇지 않으면 플러그 인이 미해결 버퍼가 반환될 때까지 새 버퍼를 요청하지 못할 수 있습니다.

메모

VPN 플러그 인과 시스템 간의 활동 및 상호 작용이 VPN 프로필에 의해 제어되므로 연결된 VPN 플러그 인 외부에서 이 API에 대한 모든 호출이 실패합니다. VPN 플러그 인에는 하나의 VPN 프로필만 매핑되어 있으므로 프로세스당 하나의 VPN 프로필만 있을 수 있으며 호출자가 둘 이상의 프로필 개체를 만드는 경우 모두 동일한 설정을 참조합니다.

추가 정보

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