Opening a Line
A version of this page is also available for
4/8/2010
To open a line device for any purpose, the application calls the lineOpen function. This function opens the specified line device and returns a line handle to the opened line device. The line handle is used in subsequent operations on the line device. Later, when the application is finished using the line device, it can close it by using the lineClose function.
Before it makes a telephone call, the application must open the line.
The lineOpen function specifies:
- A handle to the application registration with TAPI.
- A value that identifies the line device to be opened.
- A pointer to a line handle that is loaded with the handle that represents the opened line device.
- The API version number under which the application and TAPI operate compatibly. This version number is obtained by calling the lineNegotiateAPIVersion function.
- The extension version number under which the application and the service provider operate compatibly.
- User-instance data that is passed back to the application with each message that is associated with this line, or with addresses or calls on this line. This data is not interpreted by TAPI.
- The privilege that the application wants for the calls for which it is notified. This parameter can be a combination of the LINECALLPRIVILEGE constants.