Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

SQL Anywhere 11.0.1 (Deutsch) » UltraLite - C- und C++-Programmierung » API-Referenz » UltraLite ODBC API-Referenz

 

SQLAllocHandle-Funktion

Weist einen Handle für UltraLite ODBC zu.

Syntax
UL_FN_SPEC SQLRETURN UL_FN_MOD SQLAllocHandle(
SQLSMALLINT HandleType,
SQLHANDLE InputHandle,
SQLHANDLE * OutputHandle );
Parameter
  • HandleType   Der Typ des zuzuweisenden Handles. UltraLite unterstützt folgende Handle-Typen:

    • SQL_HANDLE_ENV (Umgebungs-Handle)
    • SQL_HANDLE_DBC (Verbindungs-Handle)
    • SQL_HANDLE_STMT (Anweisungs-Handle)

  • InputHandle   Der Handle, in dessen Kontext der neue Handle zugewiesen werden soll. Bei einem Verbindungs-Handle ist dies der Umgebungs-Handle, bei einem Anweisungs-Handle ist dies der Verbindungs-Handle.

  • OutputHandle   Ein Zeiger auf einen Puffer, in dem der neue Handle zurückgegeben werden soll

Bemerkungen

ODBC benutzt Handles, um den Kontext für Datenbankvorgänge zu übergeben. Ein Umgebungs-Handle bietet den Kontext für die Kommunikation mit einer Datenquelle, ähnlich wie der SQL Communications-Bereich (SQLCA) in anderen Schnittstellen. Ein Verbindungs-Handle bietet einen Kontext für alle Datenbankvorgänge. Ein Anweisungs-Handle verwaltet Ergebnismengen und Datenänderungen. Ein Deskriptor-Handle verwaltet die Verarbeitung von Datenmengen für Ergebnismengen.