16.4.4 SQLGetFunctions
- Organization of this subsection
(1) Function
This ODBC function returns information about whether the driver supports a specific ODBC function or returns a list of support information for the individual ODBC functions.
(2) Format
SQLRETURN SQLGetFunctions ( SQLHDBC ConnectionHandle, /* In */ SQLUSMALLINT FunctionId, /* In */ SQLUSMALLINT * SupportedPtr /* Out */ )
(3) Arguments
- ConnectionHandle
-
Specifies a connection handle.
- FunctionId
-
Specifies SQL_API_ODBC3_ALL_FUNCTIONS to obtain a list of support information for all functions.
To obtain information on whether a specific function is supported, specify the #define value of the target ODBC function.
- SupportedPtr
-
Specifies a pointer to the buffer in which the support information for the specified function is to be returned.
If the #define value of an ODBC function is specified for FunctionId, the function returns SQL_TRUE (supported) or SQL_FALSE (not supported).
You can also specify NULL for SupportedPtr.
(4) Return value
This ODBC function returns SQL_SUCCESS, SQL_ERROR, or SQL_INVALID_HANDLE.
(5) SQLSTATE
This ODBC function returns one of the following SQLSTATE values:
|
SQLSTATE |
Description |
Remarks |
Returned |
|---|---|---|---|
|
01000 |
General warning |
-- |
N |
|
08S01 |
Communication link failure |
N |
|
|
HY000 |
General error |
N |
|
|
HY001 |
Memory allocation error |
N |
|
|
HY010 |
Function sequence error |
Y |
|
|
HY013 |
Memory management error |
N |
|
|
HY095 |
Function type out of range |
Y |
|
|
HYT01 |
Connection timeout expired |
N |
- Legend:
-
Y: This SQLSTATE might be returned by the HADB ODBC driver.
N: This SQLSTATE is not returned by the HADB ODBC driver.
--: None