VCI - Virtual CAN Interface - Ixxat

Interface descriptionphControl[out] Pointer to a variable of type HANDLE. If run successfully, the functionreturns the handle of the opened CAN controller in this variable. In theevent of an error, the variable is set to ZERO.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 specified in the parameter dwCanNo, the functiondisplays a dialog window to select a CAN interface board and a CAN connectionon the screen. In this case the function expects the handle of a higher orderwindow, or the value ZERO if no higher order window is available, in theparameter hDevice and not the handle of the CAN interface board.4.3.1.2 canControlCloseThe function closes an opened CAN controller. The complete syntax of the functionis:HRESULT canControlClose( HANDLE hControl )Parameter:hControl[in] Handle of the CAN controller to be closed. The handle specified heremust come from a call of the function canControlOpen.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:After the function is called, the handle specified in hControl is no longer validand must no longer be used.50Copyright IXXAT Automation GmbH C-API Programming Manual, Version 1.5