ShowHierarchyDialog()

static int CApplicationAPI::ShowHierarchyDialog ( LpError  lpError, LPCTSTR  lpszIso, LPCTSTR  lpszCity, LPCTSTR  lpszStreet, BOOL  bPostal, SWayPoint *&  lpPosition, DWORD  dwMaxTime = DEFAULT_MAX_TIME  )

static

The function shows hierarchy dialog and returns location of taken address.

Parameters

lpError	Additional error information returned from Drive.
lpszIso	ISO code of map (country) where address is located. This parameter is obligatory.
lpszCity	Name of city or postal code of the city in taken country.
lpszStreet	Street in taken city.
bPostal	Flag determining whether City parameter represents city or ZIP code. true - ZIP code. false - City.
lpPosition	Reference to instance of SWayPoint type determining location of taken address.
dwMaxTime	Maximum time (in milliseconds) function can take. If dwMaxTime=0 function execution is not time limited.

Returns

1 if successful, other value otherwise.

Possible error codes returned from Drive are:

• 0 - Function not succeeded.
• 1 - Function succeeded.
• 2 - Drive not succeeded.
• 3 - Function reached timeout.