File: odbctrace.h

package info (click to toggle)
unixodbc 2.3.1-3
  • links: PTS, VCS
  • area: main
  • in suites: jessie, jessie-kfreebsd
  • size: 11,524 kB
  • ctags: 7,656
  • sloc: ansic: 89,405; sh: 15,975; makefile: 1,574; yacc: 969; sql: 1
file content (341 lines) | stat: -rw-r--r-- 26,249 bytes parent folder | download | duplicates (8)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
/*!
 * \file
 *
 * \author  Peter Harvey <pharvey@peterharvey.org> www.peterharvey.org
 * \author  \sa AUTHORS file
 * \version 1
 * \date    2007
 * \license Copyright unixODBC Project 2007-2008, LGPL
 */

/*! 
 * \mainpage    ODBC Trace Manager
 *
 * \section intro_sec Introduction
 *
 *              This library provides an interface to trace code which is cross-platform and supports plugin trace
 *              handlers. Drivers can use this to simplify support for producing trace output.
 *
 *              odbctrac is an example of a trace plugin which can be used with this trace interface.
 *
 *              odbctxt is an example of a Driver which uses this trace interface.
 */

#ifndef TRACE_H
#define TRACE_H

#include <stdio.h>
#include <sqlext.h>

typedef SQLHANDLE *HTRACECALL;                  /*!< internal call handle of trace plugin   */

/*!
 * \brief   Trace handle.
 *
 *          Create an instance of this at the desired scope. The scope could be 1 for driver or 
 *          1 for each driver handle (env, dbc, stmt, desc) or some other scope.
 *
 *          Use #traceAlloc to allocate the instance or otherwise init the struct. Then use #traceOpen
 *          and #traceClose to open/close the trace plugin. Use #traceFree when your done with the 
 *          trace handle.
 *
\code
// init
SQLHDBC pConnection;
HTRACE  pTrace = traceAlloc();
{
    char szTrace[50];
    SQLGetPrivateProfileString( "odbctxt", "TraceFile", "/tmp/sql.log", pTrace->szTraceFile, FILENAME_MAX - 2, "odbcinst.ini" );
    SQLGetPrivateProfileString( "odbctxt", "TraceLibrary", "libodbctrac.so", pTrace->szFileName, FILENAME_MAX - 2, "odbcinst.ini" );
    SQLGetPrivateProfileString( "odbctxt", "Trace", "No", szTrace, sizeof( szTrace ), "odbcinst.ini" );
    if ( szTrace[ 0 ] == '1' || toupper( szTrace[ 0 ] ) == 'Y' || ( toupper( szTrace[ 0 ] ) == 'O' && toupper( szTrace[ 1 ] ) == 'N' ) )
        traceOpen( pTrace );
}
// use (SQLConnect as example)
{
    HTRACECALL hCall = traceConnect( pTrace, pConnection, "DataSource", SQL_NTS, "UID", SQL_NTS, "PWD", SQL_NTS );

    // do connect here

    return traceReturn( pTrace, hCall, nReturn );
}
// fini
{
    traceFree( pTrace );
}
\endcode
 */
typedef struct tTRACE
{
    void *      hPlugIn;                        /*!< library handle of trace plugin         */
    char        szFileName[FILENAME_MAX];       /*!< file name of trace plugin              */
    char        szTraceFile[FILENAME_MAX];      /*!< SQL_ATTR_TRACEFILE                     */
    SQLUINTEGER nTrace;                         /*!< SQL_ATTR_TRACE                         */
    SQLHANDLE   hPlugInInternal;                /*!< internal handle of trace plugin        */

    SQLHANDLE   (*pTraceAlloc)();
    void        (*pTraceFree)();
    SQLRETURN   (*pTraceReturn)();
    RETCODE     (*pTraceOpenLogFile)();
    RETCODE     (*pTraceCloseLogFile)();

    HTRACECALL (*pTraceSQLAlloConnect)();       
    HTRACECALL (*pTraceSQLAllocEnv)();          
    HTRACECALL (*pTraceSQLAllocHandle)();       
    HTRACECALL (*pTraceSQLAllocHandleStd)();    
    HTRACECALL (*pTraceSQLAllocStmt)();         
    HTRACECALL (*pTraceSQLBindCol)();           
    HTRACECALL (*pTraceSQLBindParam)();         
    HTRACECALL (*pTraceSQLBindParameter)();     
    HTRACECALL (*pTraceSQLBrowseConnect)();     
    HTRACECALL (*pTraceSQLBrowseConnectw)();    
    HTRACECALL (*pTraceSQLBulkOperations)();    
    HTRACECALL (*pTraceSQLCancel)();            
    HTRACECALL (*pTraceSQLCloseCursor)();       
    HTRACECALL (*pTraceSQLColAttribute)();      
    HTRACECALL (*pTraceSQLColAttributes)();     
    HTRACECALL (*pTraceSQLColAttributesW)();    
    HTRACECALL (*pTraceSQLColAttributeW)();     
    HTRACECALL (*pTraceSQLColumnPrivileges)();  
    HTRACECALL (*pTraceSQLColumnPrivilegesW)(); 
    HTRACECALL (*pTraceSQLColumns)();           
    HTRACECALL (*pTraceSQLColumnsW)();          
    HTRACECALL (*pTraceSQLConnect)();           
    HTRACECALL (*pTraceSQLConnectW)();           
    HTRACECALL (*pTraceSQLCopyDesc)();          
    HTRACECALL (*pTraceSQLDataSources)();       
    HTRACECALL (*pTraceSQLDataSourcesW)();      
    HTRACECALL (*pTraceSQLDescribeCol)();       
    HTRACECALL (*pTraceSQLDescribeColW)();      
    HTRACECALL (*pTraceSQLDescribeParam)();     
    HTRACECALL (*pTraceSQLDisconnect)();        
    HTRACECALL (*pTraceSQLDriverConnect)();     
    HTRACECALL (*pTraceSQLDriverConnectW)();    
    HTRACECALL (*pTraceSQLDrivers)();           
    HTRACECALL (*pTraceSQLDriversW)();          
    HTRACECALL (*pTraceSQLEndTran)();           
    HTRACECALL (*pTraceSQLError)();             
    HTRACECALL (*pTraceSQLErrorW)();            
    HTRACECALL (*pTraceSQLExecDirect)();        
    HTRACECALL (*pTraceSQLExecDirectW)();       
    HTRACECALL (*pTraceSQLExecute)();           
    HTRACECALL (*pTraceSQLExtendedFetch)();     
    HTRACECALL (*pTraceSQLFetch)();             
    HTRACECALL (*pTraceSQLFetchScroll)();       
    HTRACECALL (*pTraceSQLForeignKeys)();       
    HTRACECALL (*pTraceSQLForeignKeysW)();      
    HTRACECALL (*pTraceSQLFreeConnect)();       
    HTRACECALL (*pTraceSQLFreeEnv)();           
    HTRACECALL (*pTraceSQLFreeHandle)();        
    HTRACECALL (*pTraceSQLFreeStmt)();          
    HTRACECALL (*pTraceSQLGetConnectAttr)();    
    HTRACECALL (*pTraceSQLGetConnectAttrW)();   
    HTRACECALL (*pTraceSQLGetConnectOption)();  
    HTRACECALL (*pTraceSQLGetConnectOptionW)(); 
    HTRACECALL (*pTraceSQLGetCursorName)();     
    HTRACECALL (*pTraceSQLGetCursorNameW)();    
    HTRACECALL (*pTraceSQLGetData)();           
    HTRACECALL (*pTraceSQLGetDescField)();      
    HTRACECALL (*pTraceSQLGetDescFieldw)();     
    HTRACECALL (*pTraceSQLGetDescRec)();        
    HTRACECALL (*pTraceSQLGetDescRecW)();       
    HTRACECALL (*pTraceSQLGetDiagField)();      
    HTRACECALL (*pTraceSQLGetDiagFieldW)();     
    HTRACECALL (*pTraceSQLGetDiagRec)();        
    HTRACECALL (*pTraceSQLGetDiagRecW)();       
    HTRACECALL (*pTraceSQLGetEnvAttr)();        
    HTRACECALL (*pTraceSQLGetFunctions)();      
    HTRACECALL (*pTraceSQLGetInfo)();           
    HTRACECALL (*pTraceSQLGetInfoW)();          
    HTRACECALL (*pTraceSQLGetStmtAttr)();       
    HTRACECALL (*pTraceSQLGetStmtAttrW)();      
    HTRACECALL (*pTraceSQLGetStmtOption)();     
    HTRACECALL (*pTraceSQLGetTypeInfo)();       
    HTRACECALL (*pTraceSQLGetTypeInfoW)();      
    HTRACECALL (*pTraceSQLMoreResults)();       
    HTRACECALL (*pTraceSQLNativeSql)();         
    HTRACECALL (*pTraceSQLNativeSqlW)();        
    HTRACECALL (*pTraceSQLNumParams)();         
    HTRACECALL (*pTraceSQLNumResultCols)();     
    HTRACECALL (*pTraceSQLParamData)();         
    HTRACECALL (*pTraceSQLParamOptions)();      
    HTRACECALL (*pTraceSQLPrepare)();           
    HTRACECALL (*pTraceSQLPrepareW)();          
    HTRACECALL (*pTraceSQLPrimaryKeys)();       
    HTRACECALL (*pTraceSQLPrimaryKeysw)();      
    HTRACECALL (*pTraceSQLProcedureColumns)();  
    HTRACECALL (*pTraceSQLProcedureColumnsw)(); 
    HTRACECALL (*pTraceSQLProcedures)();        
    HTRACECALL (*pTraceSQLProceduresW)();       
    HTRACECALL (*pTraceSQLPutData)();           
    HTRACECALL (*pTraceSQLRowCount)();          
    HTRACECALL (*pTraceSQLSetConnectAttr)();    
    HTRACECALL (*pTraceSQLSetConnectAttrW)();   
    HTRACECALL (*pTraceSQLSetConnectoption)();  
    HTRACECALL (*pTraceSQLSetConnectoptionW)(); 
    HTRACECALL (*pTraceSQLSetCursorName)();     
    HTRACECALL (*pTraceSQLSetCursorNameW)();    
    HTRACECALL (*pTraceSQLSetDescField)();      
    HTRACECALL (*pTraceSQLSetDescFieldW)();     
    HTRACECALL (*pTraceSQLSetDescRec)();        
    HTRACECALL (*pTraceSQLSetDescRecW)();       
    HTRACECALL (*pTraceSQLSetEnvAttr)();        
    HTRACECALL (*pTraceSQLSetParam)();          
    HTRACECALL (*pTraceSQLSetPos)();            
    HTRACECALL (*pTraceSQLSetScrollOptions)();  
    HTRACECALL (*pTraceSQLSetStmtAttr)();       
    HTRACECALL (*pTraceSQLSetStmtAttrW)();      
    HTRACECALL (*pTraceSQLSetStmtOption)();     
    HTRACECALL (*pTraceSQLSetStmtOptionW)();    
    HTRACECALL (*pTraceSQLSpecialColumns)();    
    HTRACECALL (*pTraceSQLSpecialColumnsW)();   
    HTRACECALL (*pTraceSQLStatistics)();        
    HTRACECALL (*pTraceSQLStatisticsW)();       
    HTRACECALL (*pTraceSQLTablePrivileges)();   
    HTRACECALL (*pTraceSQLTablePrivilegesW)();  
    HTRACECALL (*pTraceSQLTables)();            
    HTRACECALL (*pTraceSQLTablesW)();           
    HTRACECALL (*pTraceSQLTransact)();          

} TRACE, *HTRACE;

/*! 
 * \brief   Allocates a trace handle.
 * 
 *          Tracing is turned off and no trace plugin is loaded.
 *
 * \return  HTRACE
 */
HTRACE traceAlloc();

/*! 
 * \brief   Frees trace handle.
 *
 *          Compliments #traceAlloc. Will call #traceClose as needed.
 *
 *          This will call #traceClose as needed.
 * 
 * \param   pTrace
 */
void traceFree( HTRACE pTrace );

/*! 
 * \brief   Opens trace plugin.
 * 
 *          This will open/load the trace plugin/library specified in pTrace->szFileName. The
 *          trace output will go to pTrace->szTraceFile. pTrace->nTrace is set to
 *          SQL_OPT_TRACE_ON but can be set to SQL_OPT_TRACE_OFF at any time to 'pause' tracing.
 *          Set it back to SQL_OPT_TRACE_ON to resume tracing.
 *
 * \param   pTrace
 * \param   pszApplication
 * 
 * \return  int
 */
int traceOpen( HTRACE pTrace, char *pszApplication );

/*! 
 * \brief   Close trace plugin.
 * 
 *          This will close/unload the trace plugin/library. pTrace->nTrace is set to SQL_OPT_TRACE_OFF
 *          but pTrace->szTraceFile and pTrace->szFileName remain unchanged.
 *
 *          The #traceFree function will silently call #traceClose as needed.
 *
 * \param   pTrace
 */
void traceClose( HTRACE pTrace );

/* this is just to shorten the following macros */
#define traceOn ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON )

/* these macros are used to call trace plugin functions - they help by calling ONLY if relevant */
#define traceAllocConnect( pTrace, B, C ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLAllocConnect( pTrace->hPlugInInternal, B, C ) : NULL );
#define traceAllocEnv( pTrace, B ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLAllocEnv( pTrace->hPlugInInternal, B ) : NULL );
#define traceAllocHandle( pTrace, B, C, D ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLAllocHandle( pTrace->hPlugInInternal, B, C, D ) : NULL );
#define traceAllocStmt( pTrace, B, C ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLAllocStmt( pTrace->hPlugInInternal, B, C ) : NULL );
#define traceBindCol( pTrace, B, C, D, E, F, G ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLBindCol( pTrace->hPlugInInternal, B, C, D, E, F, G ) : NULL );
#define traceBindParam( pTrace, B, C, D, E, F, G, H, I ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLBindParam( pTrace->hPlugInInternal, B, C, D, E, F, G, H, I ) : NULL );
#define traceBindParameter( pTrace, B, C, D, E, F, G, H, I, J, K ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLBindParameter( pTrace->hPlugInInternal, B, C, D, E, F, G, H, I, J, K ) : NULL );
#define traceBrowseConnect( pTrace, B, C, D, E, F, G ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLBrowseConnect( pTrace->hPlugInInternal, B, C, D, E, F, G ) : NULL );
#define traceBrowseConnectW( pTrace, B, C, D, E, F, G ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLBrowseConnectW( pTrace->hPlugInInternal, B, C, D, E, F, G ) : NULL );
#define traceBulkOperations( pTrace, B, C ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLBulkOperations( pTrace->hPlugInInternal, B, C ) : NULL );
#define traceCancel( pTrace, B ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLCancel( pTrace->hPlugInInternal, B ) : NULL );
#define traceCloseCursor( pTrace, B ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLCloseCursor( pTrace->hPlugInInternal, B ) : NULL );
#define traceColAttribute( pTrace, B, C, D, E, F, G, H ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLColAttribute( pTrace->hPlugInInternal, B, C, D, E, F, G, H ) : NULL );
#define traceColAttributes( pTrace, B, C, D, E, F, G, H ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLColAttributes( pTrace->hPlugInInternal, B, C, D, E, F, G, H ) : NULL );
#define traceColAttributesW( pTrace, B, C, D, E, F, G, H ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLColAttributesW( pTrace->hPlugInInternal, B, C, D, E, F, G, H ) : NULL );
#define traceColAttributeW( pTrace, B, C, D, E, F, G, H ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLColAttributeW( pTrace->hPlugInInternal, B, C, D, E, F, G, H ) : NULL );
#define traceColumnPrivileges( pTrace, B, C, D, E, F, G, H, I, J ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLColumnPrivileges( pTrace->hPlugInInternal, B, C, D, E, F, G, H, I, J ) : NULL );
#define traceColumnPrivilegesW( pTrace, B, C, D, E, F, G, H, I, J ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLColumnPrivilegesW( pTrace->hPlugInInternal, B, C, D, E, F, G, H, I, J ) : NULL );
#define traceColumns( pTrace, B, C, D, E, F, G, H, I, J ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLColumns( pTrace->hPlugInInternal, B, C, D, E, F, G, H, I, J ) : NULL );
#define traceColumnsW( pTrace, B, C, D, E, F, G, H, I, J ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLColumnsW( pTrace->hPlugInInternal, B, C, D, E, F, G, H, I, J ) : NULL );
#define traceConnect( pTrace, B, C, D, E, F, G, H ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLConnect( pTrace->hPlugInInternal, B, C, D, E, F, G, H ) : NULL );
#define traceConnectW( pTrace, B, C, D, E, F, G, H ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLConnectW( pTrace->hPlugInInternal, B, C, D, E, F, G, H ) : NULL );
#define traceCopyDesc( pTrace, B, C ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLCopyDesc( pTrace->hPlugInInternal, B, C ) : NULL );
#define traceDataSources( pTrace, B, C, D, E, F, G, H, I ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLDataSources( pTrace->hPlugInInternal, B, C, D, E, F, G, H, I ) : NULL );
#define traceDataSourcesW( pTrace, B, C, D, E, F, G, H, I ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLDataSourcesW( pTrace->hPlugInInternal, B, C, D, E, F, G, H, I ) : NULL );
#define traceDescribeCol( pTrace, B, C, D, E, F, G, H, I, J ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLDescribeCol( pTrace->hPlugInInternal, B, C, D, E, F, G, H, I, J ) : NULL );
#define traceDescribeColW( pTrace, B, C, D, E, F, G, H, I, J ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLDescribeColW( pTrace->hPlugInInternal, B, C, D, E, F, G, H, I, J ) : NULL );
#define traceDescribeParam( pTrace, B, C, D, E, F, G ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLDescribeParam( pTrace->hPlugInInternal, B, C, D, E, F, G ) : NULL );
#define traceDisconnect( pTrace, B ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLDisconnect( pTrace->hPlugInInternal, B ) : NULL );
#define traceDriverConnect( pTrace, B, C, D, E, F, G, H, I ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLDriverConnect( pTrace->hPlugInInternal, B, C, D, E, F, G, H, I ) : NULL );
#define traceDriverConnectW( pTrace, B, C, D, E, F, G, H, I ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLDriverConnectW( pTrace->hPlugInInternal, B, C, D, E, F, G, H, I ) : NULL );
#define traceDrivers( pTrace, B, C, D, E, F, G, H, I ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLDrivers( pTrace->hPlugInInternal, B, C, D, E, F, G, H, I ) : NULL );
#define traceDriversW( pTrace, B, C, D, E, F, G, H, I ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLDriversW( pTrace->hPlugInInternal, B, C, D, E, F, G, H, I ) : NULL );
#define traceEndTran( pTrace, B, C, D ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLEndTran( pTrace->hPlugInInternal, B, C, D ) : NULL );
#define traceError( pTrace, B, C, D, E, F, G, H, I ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLError( pTrace->hPlugInInternal, B, C, D, E, F, G, H, I ) : NULL );
#define traceErrorW( pTrace, B, C, D, E, F, G, H, I ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLErrorW( pTrace->hPlugInInternal, B, C, D, E, F, G, H, I ) : NULL );
#define traceExecDirect( pTrace, B, C, D ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLExecDirect( pTrace->hPlugInInternal, B, C, D ) : NULL );
#define traceExecDirectW( pTrace, B, C, D ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLExecDirectW( pTrace->hPlugInInternal, B, C, D ) : NULL );
#define traceExecute( pTrace, B ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLExecute( pTrace->hPlugInInternal, B ) : NULL );
#define traceExtendedFetch( pTrace, B, C, D, E, F ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLExtendedFetch( pTrace->hPlugInInternal, B, C, D, E, F ) : NULL );
#define traceFetch( pTrace, B ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLFetch( pTrace->hPlugInInternal, B ) : NULL );
#define traceFetchScroll( pTrace, B, C, D ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLFetchScroll( pTrace->hPlugInInternal, B, C, D ) : NULL );
#define traceForeignKeys( pTrace, B, C, D, E, F, G, H, I, J, K, L, M, N ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLForeignKeys( pTrace->hPlugInInternal, B, C, D, E, F, G, H, I, J, K, L, M, N ) : NULL );
#define traceForeignKeysW( pTrace, B, C, D, E, F, G, H, I, J, K, L, M, N ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLForeignKeysW( pTrace->hPlugInInternal, B, C, D, E, F, G, H, I, J, K, L, M, N ) : NULL );
#define traceFreeConnect( pTrace, B ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLFreeConnect( pTrace->hPlugInInternal, B ) : NULL );
#define traceFreeEnv( pTrace, B ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLFreeEnv( pTrace->hPlugInInternal, B ) : NULL );
#define traceFreeHandle( pTrace, B, C ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLFreeHandle( pTrace->hPlugInInternal, B, C ) : NULL );
#define traceFreeStmt( pTrace, B, C ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLFreeStmt( pTrace->hPlugInInternal, B, C ) : NULL );
#define traceGetConnectAttr( pTrace, B, C, D, E, F ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLGetConnectAttr( pTrace->hPlugInInternal, B, C, D, E, F ) : NULL );
#define traceGetCursorName( pTrace, B, C, D, E ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLGetCursorName( pTrace->hPlugInInternal, B, C, D, E ) : NULL );
#define traceGetData( pTrace, B, C, D, E, F, G ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLGetData( pTrace->hPlugInInternal, B, C, D, E, F, G ) : NULL );
#define traceGetDescField( pTrace, B, C, D, E, F, G ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLGetDescField( pTrace->hPlugInInternal, B, C, D, E, F, G ) : NULL );
#define traceGetDescRec( pTrace, B, C, D, E, F, G, H, I, J, K, L ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLGetDescRec( pTrace->hPlugInInternal, B, C, D, E, F, G, H, I, J, K, L ) : NULL );
#define traceGetDiagField( pTrace, B, C, D, E, F, G, H ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLGetDiagField( pTrace->hPlugInInternal, B, C, D, E, F, G, H ) : NULL );
#define traceGetDiagRec( pTrace, B, C, D, E, F, G, H, I ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLGetDiagRec( pTrace->hPlugInInternal, B, C, D, E, F, G, H, I ) : NULL );
#define traceGetEnvAttr( pTrace, B, C, D, E, F ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLGetEnvAttr( pTrace->hPlugInInternal, B, C, D, E, F ) : NULL );
#define traceGetFunctions( pTrace, B, C, D ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLGetFunctions( pTrace->hPlugInInternal, B, C, D ) : NULL );
#define traceGetInfo( pTrace, B, C, D, E, F ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLGetInfo( pTrace->hPlugInInternal, B, C, D, E, F ) : NULL );
#define traceGetStmtAttr( pTrace, B, C, D, E, F ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLGetStmtAttr( pTrace->hPlugInInternal, B, C, D, E, F ) : NULL );
#define traceGetTypeInfo( pTrace, B, C ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLGetTypeInfo( pTrace->hPlugInInternal, B, C ) : NULL );
#define traceMoreResults( pTrace, B ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLMoreResults( pTrace->hPlugInInternal, B ) : NULL );
#define traceNativeSql( pTrace, B, C, D, E, F, G ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLNativeSql( pTrace->hPlugInInternal, B, C, D, E, F, G ) : NULL );
#define traceNumParams( pTrace, B, C ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLNumParams( pTrace->hPlugInInternal, B, C ) : NULL );
#define traceNumResultCols( pTrace, B, C ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLNumResultCols( pTrace->hPlugInInternal, B, C ) : NULL );
#define traceNumParamData( pTrace, B, C ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLParamData( pTrace->hPlugInInternal, B, C ) : NULL );
#define traceParamOptions( pTrace, B, C, D ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLParamOptions( pTrace->hPlugInInternal, B, C, D ) : NULL );
#define tracePrepare( pTrace, B, C, D ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLPrepare( pTrace->hPlugInInternal, B, C, D ) : NULL );
#define tracePrimaryKeys( pTrace, B, C, D, E, F, G, H ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLPrimaryKeys( pTrace->hPlugInInternal, B, C, D, E, F, G, H ) : NULL );
#define traceProcedureColumns( pTrace, B, C, D, E, F, G, H, I, J ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLProcedureColumns( pTrace->hPlugInInternal, B, C, D, E, F, G, H, I, J ) : NULL );
#define traceProcedures( pTrace, B, C, D, E, F, G, H ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLProcedures( pTrace->hPlugInInternal, B, C, D, E, F, G, H ) : NULL );
#define tracePutData( pTrace, B, C, D ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLPutData( pTrace->hPlugInInternal, B, C, D ) : NULL );
#define traceRowCount( pTrace, B, C ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLRowCount( pTrace->hPlugInInternal, B, C ) : NULL );
#define traceSetConnectAttr( pTrace, B, C, D, E ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLSetConnectAttr( pTrace->hPlugInInternal, B, C, D, E ) : NULL );
#define traceSetCursorName( pTrace, B, C, D ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLSetCursorName( pTrace->hPlugInInternal, B, C, D ) : NULL );
#define traceSetDescField( pTrace, B, C, D, E, F ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLSetDescField( pTrace->hPlugInInternal, B, C, D, E, F ) : NULL );
#define traceSetDescRec( pTrace, B, C, D, E, F, G, H, I, J, K ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLSetDescRec( pTrace->hPlugInInternal, B, C, D, E, F, G, H, I, J, K ) : NULL );
#define traceSetEnvAttr( pTrace, B, C, D, E ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLSetEnvAttr( pTrace->hPlugInInternal, B, C, D, E ) : NULL );
#define traceSetPos( pTrace, B, C, D, E ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLSetPos( pTrace->hPlugInInternal, B, C, D, E ) : NULL );
#define traceSetScrollOptions( pTrace, B, C, D, E ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLSetScrollOptions( pTrace->hPlugInInternal, B, C, D, E ) : NULL );
#define traceSetStmtAttr( pTrace, B, C, D, E ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLSetStmtAttr( pTrace->hPlugInInternal, B, C, D, E ) : NULL );
#define traceSpecialColumns( pTrace, B, C, D, E, F, G, H, I, J, K ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLSpecialColumns( pTrace->hPlugInInternal, B, C, D, E, F, G, H, I, J, K ) : NULL );
#define traceStatistics( pTrace, B, C, D, E, F, G, H, I, J ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLStatistics( pTrace->hPlugInInternal, B, C, D, E, F, G, H, I, J ) : NULL );
#define traceTablePrivileges( pTrace, B, C, D, E, F, G, H ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLTablePrivileges( pTrace->hPlugInInternal, B, C, D, E, F, G, H ) : NULL );
#define traceTables( pTrace, B, C, D, E, F, G, H, I, J ) ( pTrace->hPlugIn && pTrace->nTrace == SQL_OPT_TRACE_ON ? pTrace->pTraceSQLTables( pTrace->hPlugInInternal, B, C, D, E, F, G, H, I, J ) : NULL );

#define traceReturn( pTrace, pCall, nReturn ) ( pCall ? pTrace->pTraceReturn( pCall, nReturn ) : nReturn );

#endif