HotspotAuthenticationContext.IssueCredentials Método

Definição

Namespace:

Windows.Networking.NetworkOperators

Fornece credenciais para o Windows para autenticação de hotspot

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.

O Windows não armazena essas credenciais em cache e outro evento de autenticação será gerado quando o sistema se conectar ao mesmo ponto de acesso novamente.

public:
 virtual void IssueCredentials(Platform::String ^ userName, Platform::String ^ password, Platform::String ^ extraParameters, bool markAsManualConnectOnFailure) = IssueCredentials;

void IssueCredentials(winrt::hstring const& userName, winrt::hstring const& password, winrt::hstring const& extraParameters, bool const& markAsManualConnectOnFailure);

public void IssueCredentials(string userName, string password, string extraParameters, bool markAsManualConnectOnFailure);

function issueCredentials(userName, password, extraParameters, markAsManualConnectOnFailure)

Public Sub IssueCredentials (userName As String, password As String, extraParameters As String, markAsManualConnectOnFailure As Boolean)

Parâmetros

userName

String

Platform::String

winrt::hstring

O parâmetro UserName do protocolo de autenticação WISPr (Provedor de Serviços de Internet Sem Fio). 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.

Requisitos do Windows

Funcionalidades do aplicativo

cellularDeviceControl cellularDeviceIdentity

Comentários

Depois que IssueCredentials é chamado, o contexto de autenticação é finalizado e IssueCredentials, AbortAuthentication ou SkipAuthentication não devem ser chamados novamente.