lineSetCurrentLocation
This function sets the location used as the context for address translation.
LONG lineSetCurrentLocation(
HLINEAPP hLineApp,
DWORD dwLocation);
Parameters
- hLineApp
[in] Application handle returned by lineInitialize. If an application has not yet called the lineInitialize function, it can set the hLineApp parameter to NULL. - dwLocation
[in] Specifies a 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 lineGetTranslateCaps. If it is valid, the CurrentLocation entry is updated.
Return Values
Zero indicates success. A negative error number indicates that an error occurred. Possible error values are as follows:
| LINEERR_INIFILECORRUPT | LINEERR_NOMEM |
| LINEERR_INVALAPPHANDLE | LINEERR_OPERATIONFAILED |
| LINEERR_INVALLOCATION | LINEERR_RESOURCEUNAVAIL |
| LINEERR_NODRIVER | LINEERR_UNINITIALIZED |
Requirements
| Runs on | Versions | Defined in | Include | Link to |
|---|---|---|---|---|
| Windows CE OS | 2.10 and later | Tapi.h | Coredll.lib |
Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
See Also
lineGetTranslateCaps, lineInitialize
Last updated on Tuesday, July 13, 2004
© 1992-2000 Microsoft Corporation. All rights reserved.