Edit

Share via

lineSetCurrentLocation function (tapi.h)

  • Article

The lineSetCurrentLocation function sets the location used as the context for address translation.

Syntax

LONG lineSetCurrentLocation(
  HLINEAPP hLineApp,
  DWORD    dwLocation
);

Parameters

hLineApp

Application handle returned by lineInitializeEx. If an application has not yet called the lineInitializeEx function, it can set the hLineApp parameter to zero.

dwLocation

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 value

Returns zero if the request succeeds or a negative error number if an error occurs. Possible return values are:

LINEERR_INIFILECORRUPT, LINEERR_NOMEM, LINEERR_INVALAPPHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALLOCATION, LINEERR_RESOURCEUNAVAIL, LINEERR_NODRIVER, LINEERR_UNINITIALIZED.

Requirements

Requirement Value
Target Platform Windows
Header tapi.h
Library Tapi32.lib
DLL Tapi32.dll

See also

Basic Telephony Services Reference

TAPI 2.2 Reference Overview

lineGetTranslateCaps

lineInitializeEx