HotspotAuthenticationContext.IssueCredentialsAsync Método

Definição

Namespace:

Windows.Networking.NetworkOperators

Fornece credenciais de forma assíncrona ao Windows para autenticação de hotspot O Windows não armazena essas credenciais em cache e outro evento de autenticação será gerado quando o sistema se conectar ao mesmo hotspot novamente.

É uma versão assíncrona de IssueCredentials. Ele usa os mesmos parâmetros, mas a operação assíncrona só é concluída quando a autenticação é concluída. Por outro lado, a API IssueCredentials retorna assim que a autenticação é iniciada. Após a conclusão desse método, o objeto de resultados pode ser examinado para marcar o status da tentativa de autenticação.

Observação

Essa funcionalidade está disponível apenas para aplicativos de operadora móvel e aplicativos UWP com acesso privilegiado por operadoras de rede móvel.

Se você quiser usar essa API e publicar seu aplicativo na Microsoft Store, precisará de aprovação especial. Para obter mais informações, consulte a seção Funcionalidades restritas no tópico Declarações de funcionalidade do aplicativo.

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)

Parâmetros

userName

String

Platform::String

winrt::hstring

O parâmetro UserName do protocolo de autenticação WISPr (Wireless Internet Service Provider roaming). IssueCredentials executa a codificação de URL antes de enviar o valor para o servidor. Se essa cadeia de caracteres estiver vazia, o parâmetro de autenticação correspondente será ignorado.

password

String

Platform::String

winrt::hstring

O parâmetro Password do protocolo de autenticação WISPr. IssueCredentials executa a codificação de URL antes de enviar o valor para o servidor. Se essa cadeia de caracteres estiver vazia, o parâmetro de autenticação correspondente será ignorado.

extraParameters

String

Platform::String

winrt::hstring

Parâmetros adicionais a serem acrescentados à cadeia de caracteres de autenticação. IssueCredentials acrescenta esse parâmetro após um caractere "&" à cadeia de caracteres HTTP POST como está sem nenhuma codificação. Isso pode ser usado para adicionar vários parâmetros. O padrão para esse parâmetro é uma cadeia de caracteres vazia.

markAsManualConnectOnFailure

Boolean

bool

Se for true, um aplicativo desabilita permanentemente a propriedade de conexão automática em uma conexão. Se a autenticação falhar, a conexão será desconectada e não será repetida na sessão do usuário atual. Caso contrário, false.

Retornos

IAsyncOperation<HotspotCredentialsAuthenticationResult>

Resultados da solicitação de autenticação do Hotspot.

Atributos

RemoteAsyncAttribute

Requisitos do Windows

Funcionalidades do aplicativo

cellularDeviceControl cellularDeviceIdentity