HotspotAuthenticationContext.IssueCredentialsAsync Methode

Definition

Namespace:

Windows.Networking.NetworkOperators

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

IAsyncOperation<HotspotCredentialsAuthenticationResult>

Ergebnisse der Hotspot-Authentifizierungsanforderung.

Attribute

RemoteAsyncAttribute

Windows-Anforderungen

App-Funktionen

cellularDeviceControl cellularDeviceIdentity