RP1210_CLIENTDISCONNECT () Notes

This function can only be called only after a connection has been successfully established with the API. The parameter passed to this function is the identifier for the connected client to be disconnected. Typically, a call to this function will be made in the clean-up code of the client application, when it is closing. It is the responsibility of the user application to terminate all of its threads that it has created to perform the IO.

If the API DLL calls RP1210_ClientDisconnect (),  any future calls to RP1210_ReadMessage ()  or RP1210_SendMessage ( )  will return with error value ERR_CLIENT_DISCONNECTED. This method will give a client application the ability to gracefully stop any threads. Any additional disconnect information concerning thread shut down is passed back in the call to RP1210_GetHardwareStatusEx (  ). There is also no restriction on order of disconnect if an app has made multiple connections.