VCI - Virtual CAN Interface - Ixxat

Interface descriptiondwLinNo[in] Number of the LIN connection of the control unit to be opened. Thevalue 0 selects the first LIN connection, the value 1 the second LINconnection and so on.phLinCtl[out] Pointer to a variable of type HANDLE. If run successfully, the functionreturns the handle of the opened control unit in this variable. In the eventof an error, the variable is set to NULL.Return value:If run successfully, the function returns the value VCI_OK, otherwise an errorcode not equal to VCI_OK. Further information on the error code is providedby the function vciFormatError.Comments:If the value 0xFFFFFFFF is entered in the parameter dwLinNo, the function displaysa dialogue window on the screen to select a device or an interface boardand a LIN connection. In this case the function expects the handle of a higherorder window or the value NULL if no higher order window is available andnot the handle of the device in the parameter hDevice.4.4.1.2 linControlCloseThe function closes an opened LIN controller. The complete syntax of the functionis:HRESULT linControlClose ( HANDLE hLinCtl );Parameter:hLinCtl[in] Handle of the LIN control unit to be closed. The handle defined heremust come from a call of the function linControlOpen.Return value:If run successfully, the function returns the value VCI_OK, otherwise an errorcode not equal to VCI_OK. Further information on the error code is providedby the function vciFormatError.Comments:When the function is called, the handle defined in hLinCtl is no longer validand may no longer be used.77Copyright IXXAT Automation GmbH C-API Programming Manual, Version 1.5