LOCATION_REPORT_BUILDING (Windows Embedded CE 6.0)

1/6/2010

This report structure specifies the building and room of a device. Applications can register for and request reports of this time by specifying the reportType to be LOCATION_BUILDING_GUID.

See the remarks section below for how to parse this data.

Syntax

typedef struct _LOCATION_REPORT_ADDRESS {
    LOCATION_REPORT_BASE base;
    DWORD                buildingNameOffset; 
    DWORD                floorOffset;
    DWORD                roomOffset;
    DWORD                descriptionOffset;
    BYTE                 data[1];
} LOCATION_REPORT_ADDRESS, *PLOCATION_REPORT_ADDRESS;

Members

• base
  A LOCATION_REPORT_BASE structure.

• buildingNameOffset
  Name of the building, such as “1” or “Contoso Building 1”.

• floorOffset
  Name of the floor, such as “2”. Note this is always returned as a string, not a DWORD, representation.

• roomOffset
  Name of the room, such as “254”. Note this is always returned as a string, not a DWORD, representation.

• descriptionOffset
  Description of the room, such as “Michael DeVoe's Office”.

• data
  Actual data buffer containing the information above.

Remarks

The DWORD Offset fields in the structure indicate the number of bytes into the data member the actual data containing this is set. Each element is represented as a NULL terminated WCHAR string. If an entry was not determined by the plugin, the Offset will be set to LOCATION_OFFSET_UNSET (0xFFFFFFFF).

The Location Framework does not mandate the representation of countries/regions/addresses/etc…, but instead leaves this to the plugin. This means that reports generated by two separate plugins are impossible to compare for equivalence. For instance, one plugin may set the building to be “119” whereas another may set the same building as “One Hundred and Nineteen”.

Requirements

See Also

Reference

Location Framework Structures
LOCATION_REPORT_BASE