HotspotAuthenticationContext.IssueCredentials Methode

Definition

Namespace:

Windows.Networking.NetworkOperators

Stellt Anmeldeinformationen für Windows für die Hotspotauthentifizierung bereit

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 .

Windows speichert diese Anmeldeinformationen nicht zwischen, und ein anderes Authentifizierungsereignis wird ausgelöst, wenn das System erneut eine Verbindung mit demselben Hotspot herstellt.

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)

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.

Windows-Anforderungen

App-Funktionen

cellularDeviceControl cellularDeviceIdentity

Hinweise

Sobald IssueCredentials aufgerufen wurde, ist der Authentifizierungskontext abgeschlossen, und IssueCredentials, AbortAuthentication oder SkipAuthentication sollten nicht mehr aufgerufen werden.