lineSetTollList (Windows CE 5.0)
This function manipulates the toll list.
Note This function is for TAPI version 2.0 and later.
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 Values
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
OS Versions: Windows CE .NET 4.0 and later.
Header: Tapi.h.
Link Library: Coredll.lib.
See Also
Send Feedback on this topic to the authors