Client :: close - Close client handle

The function closes the client. When the handle is the last handle referring to the client object, this implies disconnecting the client when still being connected. When the client is connected to a server, the server will close all dictionaries and databases opened for the client. Thus, database resources associated with the client are not available any longer.

Closing the client will not close dictionaries and databases opened locally. Those should be closed explicitly before closing the client.

When the client handle is not valid or closing fails, the function throws an exception.