Поделиться через


lineSetCurrentLocation (Windows Embedded CE 6.0)

1/6/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

See Also

Reference

lineGetTranslateCaps
lineInitialize

Concepts

TAPI Line Device Functions