HotspotProfile

Defines the properties and login credentials for a Wi-Fi hotspot. HotspotProfile is the unique root element of a Wi-Fi hotspot profile that uses the Wireless Internet Service Provider roaming (WISPr) protocol.

Element hierarchy

<HotspotProfile>

Syntax

<HotspotProfile>

  <!-- Child elements -->
  ( ( BasicAuth,
      TrustedDomains
    )
  | ( ExtAuth,
      TrustedDomains?
    )
  ),
  UserAgent?,
  SSIDConfig?,
  any element in a non-schema namespace*

</HotspotProfile>

Key

? optional (zero or one) * optional (zero or more)

Attributes and Elements

Attributes

None.

Child Elements

Child Element Description
BasicAuth

Contains the user name and password required for WISPr authentication. Using BasicAuth allows a static set of credentials to be used; use ExtAuth to have an app generate credentials for WISPr authentication.

ExtAuth

Contains the parameters for handling WISPr authentication through an app (rather than specifying a static user name and password via BasicAuth).

SSIDConfig

Contains a set of additional SSIDs that are handled by this profile to reduce the number of SSIDs in the WLAN profile store. Windows will not connect to these SSIDs until a user manually connects once. The newly-created profile will inherit the HotspotAuth settings from this profile.

TrustedDomains

Contains a set of one or more host names that are trusted for providing credentials over HTTPS. Can be either a fully qualified name (such as hotspot.contoso.com) or a wildcard to refer to all hosts under the given domain name (such as .contoso.com).

UserAgent

Customized HTTP user agent string to support operator-specific user agent filtering. This element is optional.

Parent Elements

This outermost (document) element may not be contained by any other elements.

Requirements

Namespace

http://www.microsoft.com/networking/WLAN/HotspotProfile/v1