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.

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.

Requirements

See Also

Reference

lineInitializeEx