lineSetTollList function (tapi.h)

The lineSetTollList function manipulates the toll list.

Syntax

LONG lineSetTollList(
  HLINEAPP hLineApp,
  DWORD    dwDeviceID,
  LPCSTR   lpszAddressIn,
  DWORD    dwTollListOption
);

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.

dwDeviceID

Device identifier for the line device upon which the call is intended to be dialed, so that variations in dialing procedures on different lines can be applied to the translation process.

lpszAddressIn

TBD

dwTollListOption

Toll list operation to be performed. This parameter uses one and only one of the LINETOLLLISTOPTION_ Constants.

Return value

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

LINEERR_BADDEVICEID, LINEERR_NODRIVER, LINEERR_INVALAPPHANDLE, LINEERR_NOMEM, LINEERR_INVALADDRESS, LINEERR_OPERATIONFAILED, LINEERR_INVALPARAM, LINEERR_RESOURCEUNAVAIL, LINEERR_INIFILECORRUPT, LINEERR_UNINITIALIZED, LINEERR_INVALLOCATION.

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

lineInitializeEx