SQLAllocHandle function

Allocates a handle, for UltraLite ODBC.

Syntax
UL_FN_SPEC SQLRETURN UL_FN_MOD SQLAllocHandle(
SQLSMALLINT HandleType,
SQLHANDLE InputHandle,
SQLHANDLE * OutputHandle );
Parameters
  • HandleType   The type of handle to be allocated. UltraLite supports the following handle types:

    • SQL_HANDLE_ENV (environment handle)
    • SQL_HANDLE_DBC (connection handle)
    • SQL_HANDLE_STMT (statement handle)

  • InputHandle   The handle in whose context the new handle is to be allocated. For a connection handle, this is the environment handle; for a statement handle, this is the connection handle.

  • OutputHandle   A pointer to a buffer in which to return the new handle.

Remarks

ODBC uses handles to provide the context for database operations. An environment handle provides the context for communication with a data source, like the SQL Communications Area in other interfaces. A connection handle provides a context for all database operations. A statement handle manages result sets and data modification. A descriptor handle manages the handling of result set data types.