lineSetCurrentLocation (Windows Embedded CE 6.0)

1/6/2010

This function sets the location used as the context for address translation.

Syntax

LONG lineSetCurrentLocation( 
  HLINEAPP hLineApp, 
  DWORD dwLocation
);

hLineApp
[in] Application handle returned by the lineInitialize function. If an application has not yet called lineInitialize, it can set the hLineApp parameter to NULL.

dwLocation
[in] New value for the CurrentLocation entry in the [Locations] section in the registry. It must contain a valid permanent identifier of a Location entry in the [Locations] section, as obtained from the lineGetTranslateCaps function. If it is valid, the CurrentLocation entry is updated.

Zero indicates success. A negative error number indicates that an error occurred. The following table shows the return values for this function.

Value	Description
LINEERR_INIFILECORRUPT	The INI file is corrupted.
LINEERR_INVALAPPHANDLE	The app handle is invalid.
LINEERR_INVALLOCATION	The location provided is invalid.
LINEERR_NODRIVER	The driver was not found.
LINEERR_NOMEM	Not enough memory is available.
LINEERR_OPERATIONFAILED	The operation failed.
LINEERR_RESOURCEUNAVAIL	The resourcr is unavailable.
LINEERR_UNINITIALIZED	The parameter was uninitialized.