VpnChannel.ActivateForeground(String, ValueSet) 메서드

정의

네임스페이스:

Windows.Networking.Vpn

포그라운드에서 VPN 앱을 활성화합니다. 사용자가 자격 증명을 입력할 수 있도록 하는 데 자주 사용됩니다. IVpnPlugin.Connect구현에서만 ActivateForeground 호출할 수 있습니다. 앱이 포그라운드에 있는 동안 일반 Connect 시간 제한이 일시 중지됩니다.

ActivateForeground 호출은 일시 중지가 긴 경우(약 10분) 취소됩니다. 시작할 수 없는 경우 플러그 인은 UI(사용자 인터페이스)가 필요하지 않은 인증 방법을 이상적으로 지원해야 합니다.

SAML(Security Assertion Markup Language) 및 AAD(Azure Active Directory) 인증과 같은 웹 기반 인증 체계를 지원하기 위한 것입니다.

public:
 virtual ValueSet ^ ActivateForeground(Platform::String ^ packageRelativeAppId, ValueSet ^ sharedContext) = ActivateForeground;

ValueSet ActivateForeground(winrt::hstring const& packageRelativeAppId, ValueSet const& sharedContext);

public ValueSet ActivateForeground(string packageRelativeAppId, ValueSet sharedContext);

function activateForeground(packageRelativeAppId, sharedContext)

Public Function ActivateForeground (packageRelativeAppId As String, sharedContext As ValueSet) As ValueSet

매개 변수

packageRelativeAppId

String

Platform::String

winrt::hstring

시작할 포그라운드 앱의 PRAID(패키지 상대 애플리케이션 식별자)를 포함하는 문자열입니다.

sharedContext

ValueSet

포그라운드 앱에 정보를 전달하는 데 사용되는 ValueSet 개체입니다. 포그라운드 앱은 활성화 이벤트 인수에서 이러한 인수에 액세스할 수 있습니다.

반환

ValueSet

포그라운드 앱에서 VPN 플러그 인으로 다시 전달되어 포그라운드 요청의 결과를 나타내는 선택한 Windows 런타임 개체가 포함된 ValueSet 개체입니다.

Windows 요구 사항

디바이스 패밀리	Windows 11 (10.0.22000.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v14.0에서 도입되었습니다.)
앱 기능	networkingVpnProvider

설명

메모

VPN 플러그 인에서 IVpnPlugin.Connect 메서드 구현 외부에서 이 API를 호출하지 못합니다.

포그라운드 활성화 메커니즘을 사용하려면 여러 위치에서 활성화를 처리해야 합니다.

IVpnPlugin.Connect 메서드에서 올바른 PRAID(패키지 상대 애플리케이션 식별자) 및 포그라운드 앱에 보낼 모든 값이 포함된 ValueSet 사용하여 ActivateForeground 호출합니다.

포그라운드 앱에서 활성화를 catch해야 합니다. 포그라운드 앱은 VpnForegroundWindows.ApplicationModel.ActivationKind 값으로 활성화됩니다. 활성화 인수는 Windows.Networking.Vpn.VpnForegroundActivatedEventArgs형식이며 세 개의 필드를 포함합니다.

1. ProfileName(String).
2. SharedContext(ValueSet).
3. ActivationOperation(windows.Networking.Vpn.Vpn.VpnForegroundActivationOperation.

그런 다음 포그라운드 앱은 필요한 권한 부여(또는 필요한 데이터)를 처리하도록 앱의 UI(사용자 인터페이스)를 설정할 수 있습니다. 완료되면 ActivationOperationComplete 메서드를 호출하여 IVpnPlugin.Connect 호출에 반환하려는 값의 ValueSet 전달해야 합니다.

IVpnPlugin.Connect 호출로 돌아가서 ActivateForeground 반환된 ValueSet 사용하여 인증이 성공했는지 여부를 결정하고 오류를 처리합니다.