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 |