INDEX CLUSTER FEATURES SHORT FRAMES NO FRAMES

indexing

title: "Declaration of the ODBC API"
project: "Visual Eiffel Win32 Library"
revision: "$Revision: 1.1 $"
copyright: "Copyright (C) 1996-2005 Object Tools Group"
license: "http://visual-eiffel.com/license"
cluster: winlib
class ODBCFUN
feature -- Commands

frozen SQLAllocEnv (phenv: POINTER): INTEGER
-- This method allocates memory for an environment handle and
-- initializes the ODBC call level interface for use by an
-- application.

frozen SQLAllocConnect (henv: INTEGER; phdbc: POINTER): INTEGER
-- This method allocates memory for a connection handle within the
-- environment identified by henv.

frozen SQLAllocStmt (hdbc: INTEGER; phstmt: POINTER): INTEGER
-- This method allocates memory for a statement handle and
-- associates the statement handle with the connection specified
-- by hdbc.

frozen SQLBindCol (hstmt, irow, ctype: INTEGER; buf: POINTER; buflen: INTEGER; preslen: POINTER): INTEGER
-- This method assigns the storage and data type for a column in a
-- result set.

frozen SQLBindParameter (hstmt, ipar, partype, ctype, sqltype, prec, scale: INTEGER; buf: POINTER; bufmax: INTEGER; pbuflen: POINTER): INTEGER
-- This method binds a buffer to a parameter marker in an SQL
-- statement.

frozen SQLBrowseConnect (hdbc: INTEGER; pcsin: POINTER; csinlen: INTEGER; pcsout: POINTER; csoutmax: INTEGER; pcsoutlen: POINTER): INTEGER
-- This method supports an iterative method of discovering and
-- enumerating the attributes and attribute values required to
-- connect to a data source. Each call to SQLBrowseConnect returns
-- successive levels of attributes and attribute values. When all
-- levels have been enumerated, a connection to the data source is
-- completed and a complete connection string is produced.

frozen SQLCancel (hstmt: INTEGER): INTEGER
-- This method cancels the processing on an hstmt.

frozen SQLColAttributes (hstmt, icol, desctype: INTEGER; pdesc: POINTER; descmax: INTEGER; pdesclen: POINTER; pdescinfo: POINTER): INTEGER
-- This method returns descriptor information for a column in a
-- result set.

frozen SQLColumnPrivileges (hstmt: INTEGER; ptabqual: POINTER; tabquallen: INTEGER; ptabowner: POINTER; tabownerlen: INTEGER; ptabname: POINTER; tabnamelen: INTEGER; pcolname: POINTER; colnamelen: INTEGER): INTEGER
-- This method returns a list of columns and associated privileges
-- for the specified table. The driver returns the information as a
-- result set on the specified hstmt.

frozen SQLColumns (hstmt: INTEGER; ptabqual: POINTER; tabquallen: INTEGER; ptabowner: POINTER; tabownerlen: INTEGER; ptabname: POINTER; tabnamelen: INTEGER; pcolname: POINTER; colnamelen: INTEGER): INTEGER
-- This method returns the list of column names in specified tables.
-- The driver returns this information as a result set on the
-- specified hstmt.

frozen SQLConnect (hdbc: INTEGER; pdsn: POINTER; dsnlen: INTEGER; puser: POINTER; userlen: INTEGER; ppass: POINTER; passlen: INTEGER): INTEGER
-- This method loads a driver and establishes a connection to a data
-- source. The connection handle references storage of all
-- information about the connection, including status, transaction
-- state, and error information.

frozen SQLDataSources (henv: INTEGER; dir: INTEGER; pdsn: POINTER; dsnmax: INTEGER; pdsnlen: POINTER; pdesc: POINTER; descmax: INTEGER; pdesclen: POINTER): INTEGER
-- This method lists data source names.

frozen SQLDescribeCol (hstmt: INTEGER; icol: INTEGER; pcolname: POINTER; pcolnamemax: INTEGER; colnamelen, psqltype, pprec, pscale, pnullable: POINTER): INTEGER
-- This method returns the result descriptor - column name, type,
-- precision, scale, and nullability - for one column in the result
-- set.

frozen SQLDescribeParam (hstmt, ipar: INTEGER; psqltype, pprec, pscale, pnullable: POINTER): INTEGER
-- This method returns the description of a parameter marker
-- associated with a prepared SQL statement.

frozen SQLDisconnect (hdbc: INTEGER): INTEGER
-- This method closes the connection associated with a specific
-- connection handle

frozen SQLDriverConnect (hdbc, hwnd: INTEGER; pcsin: POINTER; csinlen: INTEGER; pcsout: POINTER; csoutmax: INTEGER; pcsoutlen: POINTER; drvcomplflag: INTEGER): INTEGER
-- This method is an alternative to 'sql_connect'. It supports data
-- sources that require more connection information than the three
-- arguments in 'sql_connect', dialog boxes to prompt the user for
-- all connection information, and data sources that are not defined
-- in the ODBC.INI file or registry.

frozen SQLDrivers (henv, dir: INTEGER; pdrvdesc: POINTER; drvdescmax: INTEGER; pdrvdesclen: POINTER; pdrvattrs: POINTER; drvattrmax: INTEGER; pdrvrattrlen: POINTER): INTEGER
-- This method lists driver descriptions and driver attribute
-- keywords. This function is implemented solely by the Driver
-- Manager.

frozen SQLError (henv, hdbc, hstmt: INTEGER; psqlstate, pnative, perrmsg: POINTER; errmsgmax: INTEGER; perrmsglen: POINTER): INTEGER
-- Returns RETCODE.

frozen SQLExecDirect (hstmt: INTEGER; psqlstr: POINTER; count: INTEGER): INTEGER
-- This method executes a preparable statement, using the current
-- values of the parameter marker variables if any parameters exist
-- in the statement.

frozen SQLExecute (hstmt: INTEGER): INTEGER
-- This method executes a prepared statement, using the current
-- values of the parameter marker variables if any parameter markers
-- exist in the statement.

frozen SQLExtendedFetch (hstmt: INTEGER; fetchtype, irow: INTEGER; prowcount, prowstatus: POINTER): INTEGER
-- This method extends the functionality of SQLFetch in the
-- following ways:
-- 1. It returns rowset data (one or more rows), in the form of an
-- array, for each bound column.
-- 2. It scrolls through the result set according to the setting of
-- a scroll-type argument.

frozen SQLFetch (hstmt: INTEGER): INTEGER
-- This method fetches a row of data from a result set.

frozen SQLForeignKeys (hstmt: INTEGER; ppktabqual: POINTER; pktabquallen: INTEGER; ppktabowner: POINTER; pktabownerlen: INTEGER; ppktabname: POINTER; pktabnamelen: POINTER; pfktabqual: POINTER; fktabquallen: INTEGER; pfktabowner: POINTER; fktabownerlen: INTEGER; pfktabname: POINTER; fktabnamelen: POINTER): INTEGER
-- This method can return:
-- 1. A list of foreign keys in the specified table (columns in the
-- specified table that refer to primary keys in other tables).
-- 2. A list of foreign keys in other tables that refer to the
-- primary key in the specified table.

frozen SQLFreeConnect (hdbc: INTEGER): INTEGER
-- This method releases a connection handle and frees all memory
-- associated with the handle.

frozen SQLFreeEnv (henv: INTEGER): INTEGER
-- This method frees the environment handle and releases all memory
-- associated with the environment handle.

frozen SQLFreeStmt (hstmt, opt: INTEGER): INTEGER
-- This method stops processing associated with a specific hstmt,
-- closes any open cursors associated with the hstmt, discards
-- pending results, and, optionally, frees all resources associated
-- with the statement handle.

frozen SQLGetConnectOption (hdbc, optcode: INTEGER; pv: POINTER): INTEGER
-- This method returns the current setting of a connection option.

frozen SQLGetCursorName (hstmt: INTEGER; pcurname: POINTER; curmax: INTEGER; pcurlen: POINTER): INTEGER
-- This method returns the cursor name associated with a specified
-- hstmt.

frozen SQLGetData (hstmt, icol, fctype: INTEGER; pvalue: POINTER; valmax: INTEGER; pvallen: POINTER): INTEGER
-- This method returns result data for a single unbound column in
-- the current row.

frozen SQLGetFunctions (hdbc, funcode: INTEGER; pexists: POINTER): INTEGER
-- This method returns information about whether a driver supports
-- a specific ODBC function. This function is implemented in the
-- Driver Manager; it can also be implemented in drivers.

frozen SQLGetInfo (hdbc, infotype: INTEGER; pinfo: POINTER; infomax: INTEGER; pinfolen: POINTER): INTEGER
-- This method returns general information about the driver and data
-- source associated with an hdbc.

frozen SQLGetStmtOption (hstmt, optcode: INTEGER; pv: POINTER): INTEGER
-- This method returns the current setting of a statement option.

frozen SQLGetTypeInfo (hstmt, sqltype: INTEGER): INTEGER
-- This method returns information about data types supported by the
-- data source. The driver returns the information in the form of an
-- SQL result set.

frozen SQLMoreResults (hstmt: INTEGER): INTEGER
-- This method determines whether there are more results available
-- on an hstmt containing SELECT, UPDATE, INSERT, or DELETE statements
-- and, if so, initializes processing for those results.

frozen SQLNativeSql (hdbc: INTEGER; psin: POINTER; sinlen: INTEGER; psout: POINTER; soutmax: INTEGER; psoutlen: POINTER): INTEGER
-- This method returns the SQL string as translated by the driver.

frozen SQLNumParams (hstmt: INTEGER; pccol: POINTER): INTEGER
-- This method returns the number of parameters in an SQL statement.

frozen SQLNumResultCols (hstmt: INTEGER; pccol: POINTER): INTEGER
-- This method returns the number of columns in a result set.

frozen SQLParamData (hstmt: INTEGER; pccol: POINTER): INTEGER
-- This method is used in conjunction with 'sql_put_data' to supply
-- parameter data at statement execution time.

frozen SQLParamOptions (hstmt, crow: INTEGER; pirow: POINTER): INTEGER
-- This method allows an application to specify multiple values for
-- the set of parameters assigned by 'sql_bind_parameter'.

frozen SQLPrepare (hstmt: INTEGER; psqlstr: POINTER; sqlstrlen: INTEGER): INTEGER
-- This method prepares a SQL string for execution.

frozen SQLPrimaryKeys (hstmt: INTEGER; ptabqual: POINTER; tabquallen: INTEGER; ptabowner: POINTER; tabownerlen: INTEGER; ptabname: POINTER; tabnamelen: INTEGER): INTEGER
-- This method returns the column names that comprise the primary
-- key for a table. The driver returns the information as a result
-- set. This function does not support returning primary keys from
-- multiple tables in a single call.

frozen SQLProcedureColumns (hstmt: INTEGER; pprocqual: POINTER; procquallen: INTEGER; pprocowner: POINTER; procownerlen: INTEGER; pprocname: POINTER; procnamelen: INTEGER; pcolname: POINTER; colnamelen: INTEGER): INTEGER
-- This method returns the list of input and output
-- parameters, as well as the columns that make up the result set
-- for the specified procedures. The driver returns the information
-- as a result set on the specified hstmt.

frozen SQLProcedures (hstmt: INTEGER; pprocqual: POINTER; procquallen: INTEGER; pprocowner: POINTER; procownerlen: INTEGER; pprocname: POINTER; procnamelen: INTEGER): INTEGER
-- This method returns the list of procedure names stored in a
-- specific data source.

frozen SQLPutData (hstmt: INTEGER; pvalue: POINTER; valuelen: INTEGER): INTEGER
-- This method allows an application to send data for a parameter or
-- column to the driver at statement execution time.

frozen SQLRowCount (hstmt: INTEGER; pcrow: POINTER): INTEGER
-- This method returns the number of rows affected by an UPDATE,
-- INSERT, or DELETE statement or by a SQL_UPDATE, SQL_ADD, or
-- SQL_DELETE operation in SQLSetPos.

frozen SQLSetConnectOption (hdbc, optcode, pv: INTEGER): INTEGER
-- This method sets options that govern aspects of connections.

frozen SQLSetCursorName (hstmt: INTEGER; pcname: POINTER; cnamelen: INTEGER): INTEGER
-- This method associates a cursor name with an active hstmt. If an
-- application does not call SQLSetCursorName, the driver generates
-- cursor names as needed for SQL statement processing.

frozen SQLSetPos (hstmt, irow, optcode, lock: INTEGER): INTEGER
-- This method sets the cursor position in a rowset and allows an
-- application to refresh, update, delete, or add data to the rowset.

frozen SQLSetScrollOptions (hstmt, concur, crowkeyset, crowrowset: INTEGER): INTEGER
-- This method sets options that control the behavior of cursors
-- associated with an hstmt, and allows the application to specify
-- the type of cursor behavior desired in three areas: concurrency
-- control, sensitivity to changes made by other transactions, and
-- rowset size.

frozen SQLSetStmtOption (hstmt, optcode, pv: INTEGER): INTEGER
-- This method sets options related to an hstmt.

frozen SQLSpecialColumns (hstmt, coltype: INTEGER; ptabqual: POINTER; tabquallen: INTEGER; ptabowner: POINTER; tabownerlen: INTEGER; ptabname: POINTER; tabnamelen, scope, nullable: INTEGER): INTEGER
-- This method retrieves the following information about columns
-- within a specified table:
-- 1. The optimal set of columns that uniquely identifies a row in
-- the table.
-- 2. Columns that are automatically updated when any value in the
-- row is updated by a transaction.

frozen SQLStatistics (hstmt: INTEGER; ptabqual: POINTER; tabquallen: INTEGER; ptabowner: POINTER; tabownerlen: INTEGER; ptabname: POINTER; tabnamelen, uniq, accuracy: INTEGER): INTEGER
-- This method retrieves a list of statistics about a single table
-- and the indexes associated with the table. The driver returns the
-- information as a result set.

frozen SQLTablePrivileges (hstmt: INTEGER; ptabqual: POINTER; tabquallen: INTEGER; ptabowner: POINTER; tabownerlen: INTEGER; ptabname: POINTER; tabnamelen: INTEGER): INTEGER
-- This method returns a list of tables and the privileges associated
-- with each table. The driver returns the information as a result
-- set on the specified hstmt.

frozen SQLTables (hstmt: INTEGER; ptabqual: POINTER; tabquallen: INTEGER; ptabowner: POINTER; tabownerlen: INTEGER; ptabname: POINTER; tabnamelen: INTEGER; ptabtype: POINTER; tabtypelen: INTEGER): INTEGER
-- This method returns the list of table names stored in a specific
-- data source. The driver returns the information as a result set.

frozen SQLTransact (henv, hdbc, type: INTEGER): INTEGER
-- This method requests a commit or rollback operation for all
-- active operations on all hstmts associated with a connection.
-- Method can also request that a commit or rollback operation
-- be performed for all connections associated with the henv.
end -- class ODBCFUN

INDEX CLUSTER FEATURES SHORT FRAMES NO FRAMES