Common Function Return ValuesΒΆ

TB_OK (1)

A number of functions that do not need to return any specific value, return this value when they have been called successfully and without errors.

TB_FUNCTION_NOT_AVAIL (-1)

This indicates that this particular API call is not currently available. Possible causes include:

  • This feature is disabled from the server side. If this is an optional feature you might need to turn it on from the Revulytics Usage Intelligence Web UI inside the customer login area.
  • You have called this function too many times in quick succession from the same client. In order to prevent abuse the server might impose a minimum interval (time threshold) before you can call this function again. This interval can vary from seconds to minutes.
  • There has been a time out on this request to the Revulytics Usage Intelligence server.

TB_CONN_ERROR (-2)

This means there was a problem communicating with the Revulytics Usage Intelligence server due to:

  • network connectivity problems
  • Incorrect proxy settings
  • HTTP traffic is blocked by a gateway or firewall

In some cases it might help testing the internet connection by calling the tbConnectionCheck() function.

TB_AUTH_FAILURE (-3)

This is typically encountered when using a proxy with Authentication enabled. Make sure you are entering the correct proxy credentials using tbSetProxy() or tbSetDefaultProxyCredentials().

TB_SERVER_ERROR (-4)

The server returned an error or specifically refused the connection. Causes:

  • You are using the wrong CallHome URL
  • You are using the wrong product ID
  • Some temporary server error occurred

Login to the Web UI to make sure your account is active and there are no critical warnings. Test using tbConnectionCheck() function.

TB_CONFIG_NOT_CREATED (-5)

The function tbCreateConfig() needs to be called before calling further configuration-related functions (Providing further data) or tbStart(). If this is not done, these functions would return TB_CONFIG_NOT_CREATED.

TB_CONFIG_ALREADY_CREATED (-6)

If the function tbCreateConfig() is called twice, on the second time, it would return this value. This means that this function should only be called once to initialize the configuration. If any value needs to be changed afterwards, this can be done by calling functions in the Providing further data section.

TB_APP_CONFIG_NOT_LOADED (-7)

This value is returned if tbStart() was not called or if it didn’t finish successfully. Functions that logically require an application to be started before they can run return this value if a call to tbStart() has not been done.

TB_INVALID_PARAMETER (-9)

This value is returned in cases where an invalid parameter value has been passed. These include cases such as where a TBINSTANCE* value is required but a NULL is passed, a valid wchar_t* (Windows) or char* (Linux/Mac OS X) value is required, but a NULL is passed instead, or when trying to stop a session via tbSessionStop(), but the session ID that is passed does not exist (has not been started).

TB_INTERNAL_ERROR (-99)

This value is returned if the Revulytics Usage Intelligence SDK experience a general unrecoverable error. Once a TB_INTERNAL_ERROR is returned from any Revulytics Usage Intelligence SDK call, the application should not make any more Revulytics Usage Intelligence SDK calls. Any subsequent calls will also return TB_INTERNAL_ERROR.