Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

To open a line device for any purpose, the application calls the lineOpenfunction. 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 lineClosefunction.

Before it makes a telephone call, the application must open the line.

The lineOpenfunction 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 lineNegotiateAPIVersionfunction.

  • 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.

See Also