/mcplineOpen The lineOpen function opens the line device that its device identifier specifies and returns a line handle for the corresponding opened line device. Subsequent operations on the line device use this line handle. Function Details LONG lineOpen( HLINEAPP hLineApp, DWORD dwDeviceID, LPHLINE lphLine, DWORD dwAPIVersion, DWORD dwExtVersion, DWORD dwCallbackInstance, DWORD dwPrivileges, DWORD dwMediaModes, LPLINECALLPARAMS const lpCallParams ); Parameters hLineApp The handle by which the application is registered with TAPI. dwDeviceID Identifies the line device to be opened. It can either be a valid device identifier or the value LINEMAPPER The Cisco Unified TSP does not support LINEMAPPER at this time. Note lphLine A pointer to an HLINE handle that is then loaded with the handle that represents the opened line device. Use this handle to identify the device when you are invoking other functions on the open line device. dwAPIVersion The API version number under which the application and Telephony API operate. Obtain this number with lineNegotiateAPIVersion. dwExtVersion The extension version number under which the application and the service provider operate. This number remains zero if the application does not use any extensions. Obtain this number with lineNegotiateExtVersion. dwCallbackInstance 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. The Telephony API does not interpret this parameter. dwPrivileges The privilege that the application wants for the calls for which it is notified. This parameter can be a combination of the LINECALLPRIVILEGE_ constants. For applications that are using TAPI version 2.0 or later, values for this parameter can also be combined with the LINEOPENOPTION_constants: Cisco Unified TAPI Developers Guide for Cisco Unified Communications Manager, Release 15 and SUs 181 Basic TAPI Implementation lineOpen