HotspotAuthenticationContext.IssueCredentialsAsync Метод

Определение

Пространство имен:

Windows.Networking.NetworkOperators

Асинхронно предоставляет учетные данные в Windows для проверки подлинности хот-спота Windows не кэширует эти учетные данные, и при повторном подключении системы к тому же хот-споту будет возникать другое событие проверки подлинности.

Это асинхронная версия IssueCredentials. Он принимает те же параметры, но асинхронная операция завершается только после завершения проверки подлинности. В отличие от этого, API IssueCredentials возвращается сразу после запуска проверки подлинности. После завершения этого метода объект результатов можно проверить, чтобы проверка состояние попытки проверки подлинности.

Примечание

Эта функция доступна только для приложений мобильных операторов и приложений 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

Параметр UserName протокола проверки подлинности WISPr. IssueCredentials выполняет кодирование URL-адреса перед отправкой значения на сервер. Если эта строка пуста, соответствующий параметр проверки подлинности пропускается.

password

String

Platform::String

winrt::hstring

Параметр Password протокола проверки подлинности WISPr. IssueCredentials выполняет кодирование URL-адреса перед отправкой значения на сервер. Если эта строка пуста, соответствующий параметр проверки подлинности пропускается.

extraParameters

String

Platform::String

winrt::hstring

Дополнительные параметры, добавляемые в строку проверки подлинности. IssueCredentials добавляет этот параметр после символа "&" в строку HTTP POST без кодирования. Это можно использовать для добавления нескольких параметров. По умолчанию для этого параметра используется пустая строка.

markAsManualConnectOnFailure

Boolean

bool

Если значение равно true, приложение окончательно отключает свойство автоматического подключения для подключения. Если проверка подлинности завершается сбоем, подключение будет отключено и не будет повторяться в текущем сеансе пользователя. В противном случае — false.

Возвращаемое значение

IAsyncOperation<HotspotCredentialsAuthenticationResult>

Результаты запроса проверки подлинности хот-спота.

Атрибуты

RemoteAsyncAttribute

Требования к Windows

Возможности приложения

cellularDeviceControl cellularDeviceIdentity