Share via


lineSetTollList

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function manipulates the toll list.

Note

This function is for TAPI version 2.0 and later.

Syntax

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

Parameters

  • hLineApp
    Application handle returned by the lineInitializeEx function. If an application has not yet called the lineInitializeEx function, it can set the hLineApp parameter to NULL.
  • dwDeviceID
    Device identifier for the line device on 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
    Pointer to a null-terminated string containing the address from which the prefix information is to be extracted for processing. This parameter must not be NULL, and it must be in the canonical address format.
  • dwTollListOption
    Toll list operation to be performed. The following table shows the values this parameter can take. This parameter uses one and only one of these constants.

    Value Description

    LINETOLLLISTOPTION_ADD

    A prefix is to be added to the toll list.

    LINETOLLLISTOPTION_REMOVE

    A prefix is to be removed from the toll list.

Return Value

Returns zero if the request succeeds or a negative error number if an error occurs. The following table shows the return values for this function.

Value Description

LINEERR_BADDEVICEID

The device identifier is incorrect.

LINEERR_NODRIVER

The driver was not found.

LINEERR_INVALAPPHANDLE

The application handle is invalid.

LINEERR_NOMEM

Not enough memory is available.

LINEERR_INVALADDRESS

The address is invalid.

LINEERR_OPERATIONFAILED

The operation failed.

LINEERR_INVALPARAM

A parameter is invalid.

LINEERR_RESOURCEUNAVAIL

The resources are unavailable.

LINEERR_INIFILECORRUPT

The INI file is corrupted.

LINEERR_UNINITIALIZED

A parameter is uninitialized.

LINEERR_INVALLOCATION

The allocation is invalid.

Requirements

Header tapi.h
Library coredll.lib
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

lineInitializeEx