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


lineSetCurrentLocation (Compact 2013)

3/26/2014

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

TAPI32.dll

See Also

Reference

TAPI Line Device Functions
lineGetTranslateCaps
lineInitialize