Share via

lineSetCurrentAddressID

  • Article

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

Use the lineSetCurrentAddressID function to set the current line address ID.

Syntax

HRESULT lineSetCurrentAddressID (
  HLINE hLine,
  DWORD dwAddressID,
);

Parameters

  • hLine
    The line device handle. The line device handle must have been previously obtained by a call to lineOpen with the proper TAPI device ID specified and a device-specific extension version successfully negotiated with lineNegotiateExtVersion.
  • lpdwAddressID
    Pointer to a DWORD-sized memory location where the address identifier is set.

Return Value

Returns a positive request identifier if the function completes asynchronously, or a negative error number if an error occurs. The dwParam2 parameter of the corresponding LINE_REPLY message is zero if the function succeeds, or it is a negative error number if an error occurs. The following are possible error return values:

  • LINEERR_RESOURCEUNAVAIL
  • LINEERR_INVALLINEHANDLE
  • LINEERR_STRUCTURETOOSMALL
  • LINEERR_INVALPOINTER
  • LINEERR_UNINITIALIZED
  • LINEERR_NOMEM
  • LINEERR_OPERATIONUNAVAIL
  • LINEERR_OPERATIONFAILED

Remarks

Not implemented for CDMA.

Requirements

Header extapi.h
Library cellcore.lib
Windows Embedded CE Windows CE .NET 4.2 and later
Windows Mobile Pocket PC for Windows Mobile 2003 and later, Smartphone for Windows Mobile 2003 and later

See Also

Reference

Extended TAPI Functions
lineGetCurrentHSCSDStatus
lineGetCurrentOperator
lineGetCurrentSystemType