Partager via


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.