Holds information for a dynamic (also called prepared) query. More...

#include <dbapi/driver/ftds100/freetds/freetds/tds.h>

Collaboration diagram for tds_dynamic:

Public Attributes
struct tds_dynamic *	next
	next in linked list, keep first More...

TDS_INT	ref_count
	reference counter so client can retain safely a pointer More...

TDS_INT	num_id
	numeric id for mssql7+ More...

char	id [30]
	id of dynamic. More...

TDS_TINYINT	emulated
	this dynamic query cannot be prepared so libTDS have to construct a simple query. More...

TDS_TINYINT	defer_close
	true if dynamic was marker to be closed when connection is idle More...

TDSPARAMINFO *	res_info
	query results More...

TDSPARAMINFO *	params
	query parameters. More...

char *	query
	saved query, we need to know original query if prepare is impossible More...

bool	defer_close
	true if dynamic was marker to be closed when connection is idle More...

Detailed Description

Holds information for a dynamic (also called prepared) query.

Definition at line 1046 of file tds.h.

Member Data Documentation

◆ defer_close [1/2]

TDS_TINYINT tds_dynamic::defer_close

true if dynamic was marker to be closed when connection is idle

Definition at line 1067 of file tds.h.

Referenced by tds_deferred_unprepare(), and tds_process_pending_closes().

◆ defer_close [2/2]

bool tds_dynamic::defer_close

true if dynamic was marker to be closed when connection is idle

Definition at line 1026 of file tds.h.

◆ emulated

TDS_TINYINT tds_dynamic::emulated

this dynamic query cannot be prepared so libTDS have to construct a simple query.

This can happen for instance is tds protocol doesn't support dynamics or trying to prepare query under Sybase that have BLOBs as parameters.

Definition at line 1063 of file tds.h.

Referenced by tds5_process_dyn_result2(), tds_needs_unprepare(), tds_process_info(), tds_process_tokens(), tds_submit_execdirect(), tds_submit_execute(), tds_submit_prepare(), and tds_submit_unprepare().

◆ id

char tds_dynamic::id

id of dynamic.

Usually this id correspond to server one but if not specified is generated automatically by libTDS

Definition at line 1057 of file tds.h.

Referenced by tds_alloc_dynamic(), tds_dynamic_deallocated(), tds_lookup_dynamic(), tds_needs_unprepare(), tds_submit_execdirect(), tds_submit_execute(), tds_submit_prepare(), and tds_submit_unprepare().

◆ next

struct tds_dynamic * tds_dynamic::next

next in linked list, keep first

Definition at line 1048 of file tds.h.

Referenced by tds_alloc_dynamic(), tds_dynamic_deallocated(), tds_free_socket(), tds_lookup_dynamic(), and tds_process_pending_closes().

◆ num_id

TDS_INT tds_dynamic::num_id

numeric id for mssql7+

Definition at line 1051 of file tds.h.

Referenced by tds7_send_execute(), tds_dynamic_deallocated(), tds_needs_unprepare(), tds_process_tokens(), tds_submit_execute(), and tds_submit_unprepare().

◆ params

TDSPARAMINFO * tds_dynamic::params

query parameters.

Mostly used executing query however is a good idea to prepare query again if parameter type change in an incompatible way (ie different types or larger size). Is also better to prepare a query knowing parameter types earlier.

Definition at line 1077 of file tds.h.

Referenced by _SQLExecute(), ct_send(), tds7_send_execute(), tds_free_input_params(), tds_multiple_execute(), tds_submit_execdirect(), tds_submit_execute(), and test().

◆ query

char * tds_dynamic::query

saved query, we need to know original query if prepare is impossible

Definition at line 1079 of file tds.h.

Referenced by tds_multiple_execute(), tds_release_dynamic(), tds_submit_execdirect(), tds_submit_execute(), and tds_submit_prepare().

◆ ref_count

TDS_INT tds_dynamic::ref_count

reference counter so client can retain safely a pointer

Definition at line 1049 of file tds.h.

Referenced by tds_alloc_dynamic(), tds_process_pending_closes(), tds_release_dynamic(), and tds_set_cur_dyn().

◆ res_info

TDSPARAMINFO * tds_dynamic::res_info

query results

Definition at line 1069 of file tds.h.

Referenced by ct_send(), tds5_process_dyn_result2(), tds_free_all_results(), tds_free_socket(), tds_process_dyn_result(), tds_process_param_result_tokens(), and tds_release_dynamic().

The documentation for this struct was generated from the following file:

include/dbapi/driver/ftds100/freetds/freetds/tds.h

Public Attributes