This function sets the location used as the context for address translation.
LONGlineSetCurrentLocation( HLINEAPPhLineApp,DWORDdwLocation);
Parameters
- 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.
Return Values
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. |
Requirements
OS Versions: Windows CE 2.10 and later.
Header: Tapi.h.
Link Library: Coredll.lib.
See Also
lineGetTranslateCaps | lineInitialize
Send Feedback on this topic to the authors