WAP Push Message Format

Windows Mobile 6.5
4/8/2010

Windows Mobile software for Windows Mobile PDA and Windows phone devices processes the push headers shown in the following table.

Push header Description

Content-Type

A required header that is implemented as defined in HTTP/1.1.

Content-Location

A header that is implemented as defined in HTTP/1.1.

Push-Flag

A bit mask flag that indicates if the initiator Uniform Resource Identifier (URI) is authenticated and the content is trusted. This flag is implemented as defined in the WAP-189-PushOTA Version 17-Feb-2000 specification.

X-WAP-Application-ID

A generic header that provides an application identifier (ID). This header is implemented as defined in the WAP-189-PushOTA Version 17-Feb-2000 specification.

X-WAP-Content-URI

A generic header that is used in caching to identify the URI of the HTTP request.

X-WAP-Initiator-URI

A generic header that identifies the WAP push initiator.

X-MS-DESC

A custom header designed to provide a brief description of the purpose of the push message. This description is displayed to the user if the user is presented with a dialog box to enter a personal identification number (PIN). This dialog box would appear during the authentication process for the message.

Bb737486.Caution(en-us,MSDN.10).gifCaution:
For the Push Router to parse push message headers, all headers must end with "\r\n". If the last header does not contain "\r\n" (that is, header1\r\nheader2\r\n\header3"), the last header will be lost.

The following is a WAP push message that can be processed by the Push Router. In the header, the content type is identified as a WAP connectivity document.

The push message also identifies that the Uniform Resource Locator (URL) of the push initiator is http://www.thephone-company.com. The push body is a provisioning XML document that is used to update two locale settings. The headers and body are not compressed.

Headers Example

X-WAP-Initiator-URI: http://www.adatum.com
Content-Type: text/vnd.wap.connectivity-xml
X-MS-DESC: Update Locale settings

XML Code Example

<?xml version="1.0"?>
<wap-provisioningdoc>
   <characteristic type= "Locale">
      <parm name= "LOCALE_SCURRENCY" value="$"/>
      <parm name= "LOCALE_SDECIMAL" value="."/>
   </characteristic>
</wap-provisioningdoc>

For information about the provisioning file syntax for different OMA Client Provisioning versions, see OMA Client Provisioning Files.

Community Additions

Show: