HotspotAuthenticationContext.IssueCredentialsAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt asynchron Anmeldeinformationen für Windows für die Hotspotauthentifizierung bereit Windows speichert diese Anmeldeinformationen nicht zwischen, und ein anderes Authentifizierungsereignis wird ausgelöst, wenn das System erneut eine Verbindung mit demselben Hotspot herstellt.
Es handelt sich um eine asynchrone Version von IssueCredentials. Es werden dieselben Parameter benötigt, aber der asynchrone Vorgang wird nur abgeschlossen, wenn die Authentifizierung abgeschlossen ist. Im Gegensatz dazu wird die IssueCredentials-API zurückgegeben, sobald die Authentifizierung gestartet wird. Nach Abschluss dieser Methode kann das Ergebnisobjekt untersucht werden, um die status des Authentifizierungsversuchs zu überprüfen.
Hinweis
Diese Funktionalität ist nur für Apps von Mobilfunkanbietern und UWP-Apps verfügbar, die privilegierten Zugriff von Mobilfunknetzbetreibern erhalten.
Wenn Sie diese API verwenden und Ihre App im Microsoft Store veröffentlichen möchten, benötigen Sie eine spezielle Genehmigung. Weitere Informationen finden Sie im Abschnitt Eingeschränkte Funktionen im Thema App-Funktionsdeklarationen .
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)Parameter
- userName
-
String
Platform::String
winrt::hstring
Der UserName-Parameter des WISPr-Authentifizierungsprotokolls (Wireless Internet Service Provider Roaming). IssueCredentials führt die URL-Codierung durch, bevor der Wert an den Server übermittelt wird. Wenn diese Zeichenfolge leer ist, wird der entsprechende Authentifizierungsparameter übersprungen.
- password
-
String
Platform::String
winrt::hstring
Der Password-Parameter des WISPr-Authentifizierungsprotokolls. IssueCredentials führt die URL-Codierung durch, bevor der Wert an den Server übermittelt wird. Wenn diese Zeichenfolge leer ist, wird der entsprechende Authentifizierungsparameter übersprungen.
- extraParameters
-
String
Platform::String
winrt::hstring
Zusätzliche Parameter, die an die Authentifizierungszeichenfolge angefügt werden sollen. IssueCredentials fügt diesen Parameter nach einem "&"-Zeichen wie ohne Codierung an die HTTP-POST-Zeichenfolge an. Dies kann verwendet werden, um mehrere Parameter hinzuzufügen. Der Standardwert für diesen Parameter ist eine leere Zeichenfolge.
- markAsManualConnectOnFailure
-
Boolean
bool
Wenn true, deaktiviert eine Anwendung die Eigenschaft für die automatische Verbindung für eine Verbindung dauerhaft. Wenn die Authentifizierung fehlschlägt, wird die Verbindung getrennt und in der aktuellen Benutzersitzung nicht wiederholt. Andernfalls lautet der Wert false.
Gibt zurück
Ergebnisse der Hotspot-Authentifizierungsanforderung.
- Attribute
Windows-Anforderungen
| App-Funktionen |
cellularDeviceControl
cellularDeviceIdentity
|