lineSetCurrentLocation
The lineSetCurentLocation
function sets the location used as the context for address translation.
LONG lineSetCurrentLocation(
|
HLINEAPP hLineApp, |
|
|
DWORD dwLocation |
|
|
); |
|
Parameters
hLineApp
The
application handle returned by lineInitializeEx. If an application has not
yet called the lineInitializeEx function, it can set the hLineApp
parameter to NULL.
dwLocation
Specifies a
new value for the CurrentLocation entry in the [Locations] section in the
registry. It must contain a valid permanent ID of a Location entry in the
[Locations] section, as obtained from lineGetTranslateCaps. If it is valid, the
CurrentLocation entry is updated.
Return Values
Returns zero
if the request is successful or a negative error number if an error has
occurred. Possible return values are:
LINEERR_INIFILECORRUPT,
LINEERR_NOMEM, LINEERR_INVALAPPHANDLE, LINEERR_OPERATIONFAILED,
LINEERR_INVALLOCATION, LINEERR_RESOURCEUNAVAIL, LINEERR_NODRIVER, LINEERR_UNINITIALIZED.
See Also