HotspotAuthenticationContext.IssueCredentialsAsync 메서드

정의

네임스페이스:

Windows.Networking.NetworkOperators

핫스폿 인증을 위해 Windows에 자격 증명을 비동기적으로 제공하면 Windows는 이러한 자격 증명을 캐시하지 않으며 시스템이 동일한 핫스팟에 다시 연결할 때 다른 인증 이벤트가 발생합니다.

IssueCredentials의 비동기 버전입니다. 동일한 매개 변수를 사용하지만 비동기 작업은 인증이 완료된 경우에만 완료됩니다. 반면 , IssueCredentials API는 인증이 시작되는 즉시 를 반환합니다. 이 메서드가 완료되면 결과 개체를 검사하여 인증 시도의 상태 검사 수 있습니다.

참고

이 기능은 모바일 네트워크 운영자가 권한 있는 액세스 권한을 부여받은 통신사 앱 및 UWP 앱에서만 사용할 수 있습니다.

이 API를 사용하고 앱을 Microsoft Store에 게시하려면 특별한 승인이 필요합니다. 자세한 내용은 앱 기능 선언 항목의 제한된기능 섹션을 참조하세요 .

public:
 virtual IAsyncOperation<HotspotCredentialsAuthenticationResult ^> ^ IssueCredentialsAsync(Platform::String ^ userName, Platform::String ^ password, Platform::String ^ extraParameters, bool markAsManualConnectOnFailure) = IssueCredentialsAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<HotspotCredentialsAuthenticationResult> IssueCredentialsAsync(winrt::hstring const& userName, winrt::hstring const& password, winrt::hstring const& extraParameters, bool const& markAsManualConnectOnFailure);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<HotspotCredentialsAuthenticationResult> IssueCredentialsAsync(string userName, string password, string extraParameters, bool markAsManualConnectOnFailure);

function issueCredentialsAsync(userName, password, extraParameters, markAsManualConnectOnFailure)

Public Function IssueCredentialsAsync (userName As String, password As String, extraParameters As String, markAsManualConnectOnFailure As Boolean) As IAsyncOperation(Of HotspotCredentialsAuthenticationResult)

매개 변수

userName

String

Platform::String

winrt::hstring

WISPr(무선 인터넷 서비스 공급자 로밍) 인증 프로토콜의 UserName 매개 변수입니다. IssueCredentials는 값을 서버에 제출하기 전에 URL 인코딩을 수행합니다. 이 문자열이 비어 있으면 해당 인증 매개 변수를 건너뜁습니다.

password

String

Platform::String

winrt::hstring

WISPr 인증 프로토콜의 Password 매개 변수입니다. IssueCredentials는 값을 서버에 제출하기 전에 URL 인코딩을 수행합니다. 이 문자열이 비어 있으면 해당 인증 매개 변수를 건너뜁습니다.

extraParameters

String

Platform::String

winrt::hstring

인증 문자열에 추가할 추가 매개 변수입니다. IssueCredentials 는 인코딩이 없는 것처럼 HTTP POST 문자열에 "&" 문자 뒤에 이 매개 변수를 추가합니다. 여러 매개 변수를 추가하는 데 사용할 수 있습니다. 이 매개 변수의 기본값은 빈 문자열입니다.

markAsManualConnectOnFailure

Boolean

bool

true이면 애플리케이션이 연결에서 자동 연결 속성을 영구적으로 사용하지 않도록 설정합니다. 인증에 실패하면 연결이 끊어지고 현재 사용자 세션에서 다시 시도되지 않습니다. 그렇지 않으면 false입니다.

반환

IAsyncOperation<HotspotCredentialsAuthenticationResult>

핫스팟 인증 요청의 결과입니다.

특성

RemoteAsyncAttribute

Windows 요구 사항

앱 기능	cellularDeviceControl cellularDeviceIdentity