Modified:
trunk/MYODBCDriver/MYODBCDriverLib/SQLGetFunctions.cpp
Log:
added some doc
Modified: trunk/MYODBCDriver/MYODBCDriverLib/SQLGetFunctions.cpp
===================================================================
--- trunk/MYODBCDriver/MYODBCDriverLib/SQLGetFunctions.cpp 2006-06-25 19:44:48 UTC (rev
388)
+++ trunk/MYODBCDriver/MYODBCDriverLib/SQLGetFunctions.cpp 2006-06-25 20:19:58 UTC (rev
389)
@@ -10,38 +10,61 @@
/*!
\internal
- \brief List of supported and unsupported functions
- in the driver.
+ \brief List of supported and unsupported functions in the driver.
+
+ The following legend can be used in conjuction with the line comments in
MYODBCDrvSupportedFunctions
+ to get an understanding of our obligations/support.
+
+ Dep - deprecated (implementation is optional)
+ DM - implemented by Driver Manager (we could implement for case when
no DM)
+ Std - implemented by Driver Manager to map calls for X/Open standards
compliance (we could implement for case when no DM)
+
+ Its worth mentioning, here, that there are versions of the functions
which are
+ decorated with a suffix.
+
+ undecorated - Maps to W or A where applicable (not all functions have a
decorated version).
+ W - Wide char (UNICODE) version of function.
+ A - ANSI char version of function.
+
+ A driver can implement just the Wide version, ANSI (undecorated is same
as ANSI in a driver),
+ or both. The DM considers the driver to be a UNICODE driver if it finds
that it implements
+ and exports SQLConnectW().
+
+ This driver, at this time, implements the Wide version of a function when
given a choice and in
+ such a case - does NOT implement the ANSI. This should not matter to
either a UNICODE or ANSI
+ application using the driver via the DM but does limit the app when it is
linked directly to the
+ driver. For this reason; the ANSI versions will likley be implemented at
some point in the
+ future (so we will have both).
*/
SQLINTEGER MYODBCDrvSupportedFunctions[]=
{
-/* SQL_API_SQLALLOCCONNECT, */
-/* SQL_API_SQLALLOCENV, */
+/* SQL_API_SQLALLOCCONNECT, Dep */
+/* SQL_API_SQLALLOCENV, Dep */
SQL_API_SQLALLOCHANDLE,
-/* SQL_API_SQLALLOCSTMT, */
+/* SQL_API_SQLALLOCSTMT, Dep */
SQL_API_SQLBINDCOL,
-/* SQL_API_SQLBINDPARAM, */
-/* SQL_API_SQLCANCEL, */
+/* SQL_API_SQLBINDPARAM, Dep */
+/* SQL_API_SQLCANCEL, Dep */
SQL_API_SQLCLOSECURSOR,
SQL_API_SQLCOLATTRIBUTE,
SQL_API_SQLCOLUMNS,
SQL_API_SQLCONNECT,
SQL_API_SQLCOPYDESC,
-/* SQL_API_SQLDATASOURCES, */
-/* SQL_API_SQLDESCRIBECOL, */
+/* SQL_API_SQLDATASOURCES, DM */
+/* SQL_API_SQLDESCRIBECOL, */
SQL_API_SQLDISCONNECT,
-/* SQL_API_SQLENDTRAN, */
-/* SQL_API_SQLERROR, */
+/* SQL_API_SQLENDTRAN, */
+/* SQL_API_SQLERROR, Dep */
SQL_API_SQLEXECDIRECT,
SQL_API_SQLEXECUTE,
SQL_API_SQLFETCH,
-/* SQL_API_SQLFETCHSCROLL, */
-/* SQL_API_SQLFREECONNECT, */
-/* SQL_API_SQLFREEENV, */
+/* SQL_API_SQLFETCHSCROLL, */
+/* SQL_API_SQLFREECONNECT, Dep */
+/* SQL_API_SQLFREEENV, Dep */
SQL_API_SQLFREEHANDLE,
SQL_API_SQLFREESTMT,
SQL_API_SQLGETCONNECTATTR,
-/* SQL_API_SQLGETCONNECTOPTION, */
+/* SQL_API_SQLGETCONNECTOPTION, Dep */
SQL_API_SQLGETCURSORNAME,
SQL_API_SQLGETDATA,
SQL_API_SQLGETDESCFIELD,
@@ -52,47 +75,47 @@
SQL_API_SQLGETFUNCTIONS,
SQL_API_SQLGETINFO,
SQL_API_SQLGETSTMTATTR,
-/* SQL_API_SQLGETSTMTOPTION, */
+/* SQL_API_SQLGETSTMTOPTION, Dep */
SQL_API_SQLGETTYPEINFO,
SQL_API_SQLNUMRESULTCOLS,
-/* SQL_API_SQLPARAMDATA, */
+/* SQL_API_SQLPARAMDATA, */
SQL_API_SQLPREPARE,
-/* SQL_API_SQLPUTDATA, */
+/* SQL_API_SQLPUTDATA, */
SQL_API_SQLROWCOUNT,
SQL_API_SQLSETCONNECTATTR,
-/* SQL_API_SQLSETCONNECTOPTION, */
+/* SQL_API_SQLSETCONNECTOPTION, Dep */
SQL_API_SQLSETCURSORNAME,
SQL_API_SQLSETDESCFIELD,
SQL_API_SQLSETDESCREC,
SQL_API_SQLSETENVATTR,
-/* SQL_API_SQLSETPARAM */
+/* SQL_API_SQLSETPARAM Dep */
SQL_API_SQLSETSTMTATTR,
-/* SQL_API_SQLSETSTMTOPTION, */
-/* SQL_API_SQLSPECIALCOLUMNS, */
-/* SQL_API_SQLSTATISTICS, */
+/* SQL_API_SQLSETSTMTOPTION, Dep */
+/* SQL_API_SQLSPECIALCOLUMNS, */
+/* SQL_API_SQLSTATISTICS, */
SQL_API_SQLTABLES,
-/* SQL_API_SQLTRANSACT, */
-/* SQL_API_SQLALLOCHANDLESTD */
-/* SQL_API_SQLBULKOPERATIONS, */
+/* SQL_API_SQLTRANSACT, Dep */
+/* SQL_API_SQLALLOCHANDLESTD Std */
+/* SQL_API_SQLBULKOPERATIONS, */
SQL_API_SQLBINDPARAMETER,
-/* SQL_API_SQLBROWSECONNECT, */
-/* SQL_API_SQLCOLATTRIBUTES, */
-/* SQL_API_SQLCOLUMNPRIVILEGES, */
-/* SQL_API_SQLDESCRIBEPARAM, */
+/* SQL_API_SQLBROWSECONNECT, */
+/* SQL_API_SQLCOLATTRIBUTES, Dep */
+/* SQL_API_SQLCOLUMNPRIVILEGES, */
+/* SQL_API_SQLDESCRIBEPARAM, */
SQL_API_SQLDRIVERCONNECT,
-/* SQL_API_SQLDRIVERS, */
-/* SQL_API_SQLEXTENDEDFETCH, */
-/* SQL_API_SQLFOREIGNKEYS, */
-/* SQL_API_SQLMORERESULTS, */
+/* SQL_API_SQLDRIVERS, DM */
+/* SQL_API_SQLEXTENDEDFETCH, Dep */
+/* SQL_API_SQLFOREIGNKEYS, */
+/* SQL_API_SQLMORERESULTS, */
SQL_API_SQLNATIVESQL,
-/* SQL_API_SQLNUMPARAMS, */
-/* SQL_API_SQLPARAMOPTIONS, */
-/* SQL_API_SQLPRIMARYKEYS, */
-/* SQL_API_SQLPROCEDURECOLUMNS, */
-/* SQL_API_SQLPROCEDURES, */
-/* SQL_API_SQLSETPOS, */
-/* SQL_API_SQLSETSCROLLOPTIONS, */
-/* SQL_API_SQLTABLEPRIVILEGES */
+/* SQL_API_SQLNUMPARAMS, */
+/* SQL_API_SQLPARAMOPTIONS, Dep */
+/* SQL_API_SQLPRIMARYKEYS, */
+/* SQL_API_SQLPROCEDURECOLUMNS, */
+/* SQL_API_SQLPROCEDURES, */
+/* SQL_API_SQLSETPOS, */
+/* SQL_API_SQLSETSCROLLOPTIONS, Dep */
+/* SQL_API_SQLTABLEPRIVILEGES */
};
/*!
| Thread |
|---|
| • Connector/ODBC 5 commit: r389 - trunk/MYODBCDriver/MYODBCDriverLib | pharvey | 25 Jun |
