Share via


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

  • 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

Header lfapi.h
Windows Embedded CE Windows Embedded CE 6.0 and later

See Also

Reference

Location Framework Structures
LOCATION_REPORT_BASE