PhoneBookEntry (Windows Embedded CE)

10/16/2008

This structure describes a Point of Interest (POI) entry in the resulting online phone-book listing for White Pages (residential) or Yellow Pages (commercial) from the Live Search Engine.

Syntax

typedef struct _PhoneBookEntry
{
    SEARCH_LOCATION*       pCurbsideLocation;
    SEARCH_LOCATION*       pRooftopLocation;
    RESULT_CATEGORIES*     pCategories;
    DWORD                  dwSearchResultType;
    DOUBLE                 dbRating;
    WCHAR*                 lpszPhoneBookID;
    WCHAR*                 lpszName;
    WCHAR*                 lpszAddressLine;
    WCHAR*                 lpszCity;
    WCHAR*                 lpszProvince;
    WCHAR*                 lpszPostalCode;
    WCHAR*                 lpszCountryCode;
    WCHAR*                 lpszPhoneNumber;
    WCHAR*                 lpszFaxNumber;
    WCHAR*                 lpszTollFreeNumber;
    WCHAR*                 lpszWebsite;
    WCHAR*                 lpszEmail;
    WCHAR*                 lpszHoursOfOperation;
    WCHAR*                 lpszPaymentOptions;
} PhoneBookEntry;

Members

• pCurbsideLocation
  Points to a SEARCH_LOCATION structure that describes the location of the Point of Interest (POI) in terms of a curbside latitude and longitude. This is a location with suitable coordinates for driving directions.

• pRooftopLocation
  Points to a SEARCH_LOCATION structure that describes the location of this Point of Interest (POI) by using rooftop geocoding, a mapping technology that provides more precise latitude and longitude values for pinpointing a particular POI on a map.

• pCategories
  Points to a RESULT_CATEGORIES structure that contains the ID of the category that this Point of Interest (POI) belongs to.

• dwSearchResultType
  DWORD that indicates the search-result type for this Point of Interest (POI). For possible values, see Search Result Type Constants.

• dbRating
  Indicates the numeric rating of this search result. For more information, see the Remarks in Search Result Field Constants.

• lpszPhoneBookID
  Points to a string that contains the phone-book ID, which is a unique identifier for this search result.

• lpszName
  Points to a string that contains the name of this Point of Interest (POI).

• lpszAddressLine
  Points to a string that contains the address of this Point of Interest (POI).

• lpszCity
  Points to a string that contains the city of this Point of Interest (POI).

• lpszProvince
  Points to a string that contains the province of this Point of Interest (POI).

• lpszPostalCode
  Points to a string that contains the postal code of this Point of Interest (POI).

• lpszCountryCode
  Points to a string that contains the country/region code of this Point of Interest (POI).

• lpszPhoneNumber
  Points to a string that contains the phone number for this Point of Interest (POI).

• lpszFaxNumber
  Points to a string that contains the fax number for this Point of Interest (POI).

• lpszTollFreeNumber
  Points to a string that contains the toll-free number for this Point of Interest (POI).

• lpszWebsite
  Points to a string that contains the Web-site address for this Point of Interest (POI).

• lpszEmail
  Points to a string that contains the e-mail address for this Point of Interest (POI).

• lpszHoursOfOperation
  Points to a string that contains the hours of operation for this Point of Interest (POI).

• lpszPaymentOptions
  Points to a string that describes the payment options for this Point of Interest (POI).

Remarks

If a member of this structure is Null in the search response, this means that the corresponding information is either not requested or not available.

The value of lpszPostalCode must not be exposed in an initial search results list. The Live Search application UI can display this value only in a More Info screen.

Requirements

Header	localsearch.h
Library	localsearch.lib
Windows Embedded CE	Windows CE 5.0, Windows Embedded NavReady 2009

See Also

Reference

PhoneBookEntryCollection
LS4D Structures