GetLocationInfo() [1/2]

static int CApplicationAPI::GetLocationInfo ( LpError  lpError, LONGPOSITION  cpLocation, LPTSTR  lpszAddress, DWORD  dwMaxTime = DEFAULT_MAX_TIME  )

static

The function returns address corresponding to given location.

Parameters

lpError	Additional error information returned from Drive.
cpLocation	Location for which is the address searched.
lpszAddress	Found address in format: "ISO,city,street,house number"
dwMaxTime	Maximum time (in milliseconds) function can take. If dwMaxTime=0 function execution is not time limited.

Returns

1 if successful, other value otherwise.

The list of ISO codes can be found at http://userpage.chemie.fu-berlin.de/diverse/doc/ISO_3166.html.
ISO code of United States of America consists of character "U" plus code of state. E.g New York has ISO code UNY.

See Coordinates conversion section in TROUBLESHOOTING page.

Possible error codes returned from Drive are:

• 0 - Function not succeeded.
• 1 - Function succeeded.
• 2 - Drive not succeeded.
• 3 - Function reached timeout.
• -1 - Location info was not found because of invalid location syntax.