HotspotAuthenticationContext Klasse

Definition

Namespace:

Windows.Networking.NetworkOperators

Stellt den Authentifizierungskontext bereit, der Details zum aktuellen Authentifizierungsversuch enthält, und stellt Methoden zum Durchführen der Authentifizierung bereit.

Hinweis

Diese Funktionalität steht nur für Mobilfunkanbieter-Apps und UWP-Apps mit privilegiertem Zugriff durch Mobilfunknetzbetreiber zur Verfügung.

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 ref class HotspotAuthenticationContext sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class HotspotAuthenticationContext final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class HotspotAuthenticationContext

Public NotInheritable Class HotspotAuthenticationContext

Vererbung

Object Platform::Object IInspectable HotspotAuthenticationContext

Attribute

ContractVersionAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)
App-Funktionen	cellularDeviceControl cellularDeviceIdentity

Eigenschaften

AuthenticationUrl	Ruft die https-URL ab, die in der WiSPr-Umleitungsnachricht (Wireless Internet Service Provider Roaming) angegeben ist. Hinweis Diese Funktionalität steht nur für Mobilfunkanbieter-Apps und UWP-Apps mit privilegiertem Zugriff durch Mobilfunknetzbetreiber zur Verfügung. 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 . Anwendungen müssen bestimmen, ob diese URL für die Bereitstellung von Anmeldeinformationen als vertrauenswürdig eingestuft werden soll.
NetworkAdapter	Ruft die Netzwerkschnittstelle ab, die mit dem WLAN-Zugriffspunkt des Hotspots verbunden ist. Hinweis Diese Funktionalität steht nur für Mobilfunkanbieter-Apps und UWP-Apps mit privilegiertem Zugriff durch Mobilfunknetzbetreiber zur Verfügung. 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 .
RedirectMessageUrl	Ruft die URL der Webseite ab, auf der die WISPr-Umleitungsmeldung (Wireless Internet Service Provider Roaming) gefunden wurde. Hinweis Diese Funktionalität steht nur für Mobilfunkanbieter-Apps und UWP-Apps mit privilegiertem Zugriff durch Mobilfunknetzbetreiber zur Verfügung. 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 .
RedirectMessageXml	Ruft das XML-Blob der WISPr-Umleitungsnachricht (Wireless Internet Service Provider Roaming) des Hotspots ab. Hinweis Diese Funktionalität steht nur für Mobilfunkanbieter-Apps und UWP-Apps mit privilegiertem Zugriff durch Mobilfunknetzbetreiber zur Verfügung. 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 .
WirelessNetworkId	Ruft die SSID des WLAN-Zugriffspunkts des Hotspots ab. Hinweis Diese Funktionalität steht nur für Mobilfunkanbieter-Apps und UWP-Apps mit privilegiertem Zugriff durch Mobilfunknetzbetreiber zur Verfügung. 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 .

Methoden

AbortAuthentication(Boolean)	Bricht den aktuellen Authentifizierungsversuch ab und trennt die WLAN-Schnittstelle vom Hotspot. Hinweis Diese Funktionalität steht nur für Mobilfunkanbieter-Apps und UWP-Apps mit privilegiertem Zugriff durch Mobilfunknetzbetreiber zur Verfügung. 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 .
IssueCredentials(String, String, String, Boolean)	Stellt Anmeldeinformationen für Windows für die Hotspotauthentifizierung bereit. Hinweis Diese Funktionalität steht nur für Mobilfunkanbieter-Apps und UWP-Apps mit privilegiertem Zugriff durch Mobilfunknetzbetreiber zur Verfügung. 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 weiteres Authentifizierungsereignis wird ausgelöst, wenn das System erneut eine Verbindung mit demselben Hotspot herstellt.
IssueCredentialsAsync(String, String, String, Boolean)	Stellt asynchron Anmeldeinformationen für Windows für die Hotspotauthentifizierung bereit. Windows speichert diese Anmeldeinformationen nicht zwischen, und ein weiteres 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 verwendet, aber der asynchrone Vorgang wird erst abgeschlossen, wenn die Authentifizierung abgeschlossen ist. Im Gegensatz dazu gibt die IssueCredentials-API zurück, 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 steht nur für Mobilfunkanbieter-Apps und UWP-Apps mit privilegiertem Zugriff durch Mobilfunknetzbetreiber zur Verfügung. 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 .
SkipAuthentication()	Überspringt WLAN-Roaminganbieter (WISPr) Windows-Authentifizierung. Hinweis Diese Funktionalität steht nur für Mobilfunkanbieter-Apps und UWP-Apps mit privilegiertem Zugriff durch Mobilfunknetzbetreiber zur Verfügung. 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 .
TriggerAttentionRequired(String, String)	Wird von einem Hintergrundaufgabenhandler aufgerufen, um die Vordergrundanwendung zu starten, wenn ein Authentifizierungsversuch durchgeführt wird. Hinweis Diese Funktionalität steht nur für Mobilfunkanbieter-Apps und UWP-Apps mit privilegiertem Zugriff durch Mobilfunknetzbetreiber zur Verfügung. 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 startet die angegebene Anwendung.
TryGetAuthenticationContext(String, HotspotAuthenticationContext)	Ruft den Kontext eines Authentifizierungsversuchs ab. Hinweis Diese Funktionalität steht nur für Mobilfunkanbieter-Apps und UWP-Apps mit privilegiertem Zugriff durch Mobilfunknetzbetreiber zur Verfügung. 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 .

Weitere Informationen

• HotspotAuthenticationEventDetails