lineSetCurrentLocation
A version of this page is also available for
4/8/2010
This function sets the location used as the context for address translation.
Syntax
LONG lineSetCurrentLocation(
HLINEAPP hLineApp,
DWORD dwLocation
);
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 Value
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
| Header | tapi.h |
| Library | coredll.lib |
| Windows Embedded CE | Windows CE 2.10 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |