HotspotAuthenticationContext.IssueCredentialsAsync Metodo

Definizione

Fornisce in modo asincrono le credenziali a Windows per l'autenticazione hotspot Windows non memorizza nella cache queste credenziali e verrà generato un altro evento di autenticazione quando il sistema si connette di nuovo allo stesso hotspot.

È una versione asincrona di IssueCredentials. Accetta gli stessi parametri, ma l'operazione asincrona viene completata solo al termine dell'autenticazione. Al contrario, l'API IssueCredentials restituisce non appena viene avviata l'autenticazione. Al termine di questo metodo, l'oggetto risultati può essere esaminato per controllare lo stato del tentativo di autenticazione.

Nota

Questa funzionalità è disponibile solo per le app degli operatori mobili e le app UWP date l'accesso con privilegi dagli operatori di rete mobile.

Se si vuole usare questa API e pubblicare l'app in Microsoft Store, sarà necessaria un'approvazione speciale. Per altre informazioni, vedere la sezione Funzionalità limitate nell'argomento Dichiarazioni di funzionalità app.

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)

Parametri

userName
String

Platform::String

winrt::hstring

Parametro UserName del protocollo di autenticazione WiSPr (Wireless Internet Service Provider roaming). IssueCredentials esegue la codifica URL prima di inviare il valore al server. Se questa stringa è vuota, il parametro di autenticazione corrispondente viene ignorato.

password
String

Platform::String

winrt::hstring

Parametro Password del protocollo di autenticazione WISPr. IssueCredentials esegue la codifica URL prima di inviare il valore al server. Se questa stringa è vuota, il parametro di autenticazione corrispondente viene ignorato.

extraParameters
String

Platform::String

winrt::hstring

Parametri aggiuntivi da aggiungere alla stringa di autenticazione. IssueCredentials aggiunge questo parametro dopo un carattere "&" alla stringa HTTP POST così come non è alcuna codifica. Questa operazione può essere usata per aggiungere più parametri. Il valore predefinito per questo parametro è una stringa vuota.

markAsManualConnectOnFailure
Boolean

bool

Se true, un'applicazione disabilita definitivamente la proprietà di connessione automatica in una connessione. Se l'autenticazione ha esito negativo, la connessione verrà disconnessa e non eseguita nuovamente nella sessione utente corrente. In caso contrario, false.

Restituisce

Risultati della richiesta di autenticazione hotspot.

Attributi

Requisiti Windows

Funzionalità dell'app
cellularDeviceControl cellularDeviceIdentity

Si applica a