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 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
Last updated on Saturday, April 10, 2004
© 1992-2003 Microsoft Corporation. All rights reserved.