lineSetCurrentLocation

This function sets the location used as the context for address translation.

At a Glance

Syntax

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: