SQL_ThreadQuery

Syntax

native SQL_ThreadQuery(Handle:db_tuple, const handler[], const query[], const data[]="", dataSize=0);

Usage

Tuple handle, returned from SQL_MakeDbTuple().

A function to be called when the query finishes. It has to be public.

The query string.

Additional data array that will be passed to the handler function.

The size of the additional data array.

Description

Prepares and executes a threaded query.

Note

• The handler should look like:
  public QueryHandler(failstate, Handle:query, error[], errnum, data[], size, Float:queuetime)
  failstate - One of the three TQUERY_ defines.
  query - Handle to the query, do not free it.
  error - An error message, if any.
  errnum - An error code, if any.
  data - Data array you passed in.
  size - Size of the data array you passed in.
  queuetime - Amount of gametime that passed while the query was resolving.

• This will not interrupt gameplay in the event of a poor/lossed
  connection, however, the interface is more complicated and
  asynchronous. Furthermore, a new connection/disconnection is
  made for each query to simplify driver support.

• The handle does not need to be freed.

Return

This function has no return value.

Error

Thread worker was unable to start.
Invalid info tuple handle.
Handler function not found.