WPS File Updates

Note  Wireless Provisioning Services (WPS) is no longer available as of Windows Vista.

 

Once saved in the WPS provisioning store, newer versions of the XML files can be automatically downloaded from the WISP following a TTL expiration. WPS uses the following procedure when updating an XML Master file and related subfiles:

  • Once the TTL value expires, WPS will download a new copy of the Master file from the WISP's HTTPS URL.

  • For each subfile within the Master file, WPS will compare the version from the current Master file to the version from the downloaded Master file. WPS will update the subfile only if the downloaded Master file defines a higher version number.

    Since subfiles are defined within language groups in the XML Master file, only the groups for languages supported on the client will be upgraded.

  • If the downloaded Master file contains a list of other Master files, WPS will perform an upgrade for each Master file (including subfiles) within the list.

  • WPS will then store the downloaded subfiles within the provisioning store.

If a WISP's XML files were pre-provisioned through the IProvisioningDomain::Addmethod, WPS will perform the upgrade automatically once the user has connected to a wireless network.

After each Master file and subfile is downloaded, WPS will verify the XML data against the related schema. If the data is valid, then WPS will save it in the provisioning store. Otherwise, WPS will reject the file and issue an event log message within the System log. The Network Provisioning Service will post an error event describing the following:

  • The name of the XML file that failed validation

  • The reason for the failure

The following screen shot shows an example of an event log message describing an XML validation error.

 

 

Send comments about this topic to Microsoft