Share via


ODBC-functies en de cursorbibliotheek

Van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

Belangrijk

Deze functie wordt verwijderd in een toekomstige versie van Windows. Vermijd het gebruik van deze functie in nieuwe ontwikkelwerkzaamheden en plan om toepassingen te wijzigen die deze functie momenteel gebruiken. Microsoft raadt aan de cursorfunctionaliteit van het stuurprogramma te gebruiken.

De ODBC-cursorbibliotheek biedt schuifbare cursorondersteuning voor ODBC 2.x-stuurprogramma's die alleen cursors voor doorsturen ondersteunen. Wanneer u de cursorbibliotheek voor een verbinding inschakelt, onderschept Driver Manager functieaanroepen en stuurt deze door de cursorbibliotheek in plaats van rechtstreeks naar het stuurprogramma. De cursorbibliotheek voert de functie zelf uit of geeft deze door aan het onderliggende stuurprogramma.

Functies uitgevoerd door de cursorbibliotheek

In deze artikelen wordt beschreven welke ODBC-functies de cursorbibliotheek verwerkt en welke deze doorgeeft aan het stuurprogramma.

Article Description
ODBC-functies uitgevoerd door de cursorbibliotheek Bevat functies die door de cursorbibliotheek zelf worden geïmplementeerd om schuifbare cursorfunctionaliteit te bieden.
ODBC-functies die niet worden uitgevoerd door de cursorbibliotheek Bevat functies die de cursorbibliotheek zonder wijziging doorgeeft aan het stuurprogramma.

Kolom- en parameterbinding

Deze functies verwerken bindingstoepassingsbuffers naar parameters voor resultatensetkolommen en instructieparameters. De cursorbibliotheek wijzigt hun gedrag om positieupdates te ondersteunen en cursors te blokkeren.

Functie Description
SQLBindCol (cursorbibliotheek) Hiermee worden toepassingsbuffers gekoppeld aan kolommen in de resultatenset. In de cursorbibliotheek worden bindingen bijgehouden ter ondersteuning van positie-update- en verwijderbewerkingen.
SQLBindParameter (cursorbibliotheek) Hiermee worden toepassingsbuffers gekoppeld aan parametermarkeringen. De cursorbibliotheek geeft deze aanroep door aan het stuurprogramma.

Bulk- en positiebewerkingen

Deze functies voeren bulkbewerkingen uit op rijensets en positieupdates voor afzonderlijke rijen binnen de huidige rijenset van een cursor.

Functie Description
SQLBulkOperations (cursorbibliotheek) Voert bulksgewijs invoegen, bijwerken, verwijderen of ophalen op bladwijzerbewerkingen uit. De cursorbibliotheek wijst dit toe SQLSetPos wanneer u met ODBC 2.x-stuurprogramma's werkt.
SQLSetPos (cursorbibliotheek) Plaatst de cursor in een rijset en stelt toepassingen in staat om gegevens in de rijenset te vernieuwen, bij te werken of te verwijderen.

Cursorbeheer en transacties

Deze functies beheren de levensduur en transactiegrenzen van de cursor.

Functie Description
SQLCloseCursor (cursorbibliotheek) Hiermee sluit u een cursor op een instructie en verwijdert u de resultaten die in behandeling zijn.
SQLEndTran (cursorbibliotheek) Een transactie doorvoert of terugdraait. De cursorbibliotheek beheert de cursorstatus over transactiegrenzen op basis van de SQL_CURSOR_COMMIT_BEHAVIOR en SQL_CURSOR_ROLLBACK_BEHAVIOR instellingen.
SQLFreeStmt (cursorbibliotheek) Stopt de verwerking van de instructie, sluit een gekoppelde cursor, verwijdert in behandeling zijnde resultaten en maakt eventueel alle resources vrij die zijn gekoppeld aan de instructiegreep.

Gegevens ophalen

Met deze functies worden gegevens opgehaald uit resultatensets. De cursorbibliotheek biedt schuifbare cursorfunctionaliteit voor stuurprogramma's die alleen cursors voor forward-only ondersteunen.

Functie Description
SQLFetch (cursorbibliotheek) Haalt de volgende rijenset met gegevens op uit de resultatenset. Wanneer u met ODBC 2.x-stuurprogramma's werkt, wordt dit toegewezen aan SQLExtendedFetchde cursorbibliotheek.
SQLFetchScroll (cursorbibliotheek) Haalt de opgegeven rijenset met gegevens op uit de resultatenset en retourneert gegevens voor alle afhankelijke kolommen. Ondersteunt verschillende schuifrichtingen, waaronder eerste, laatste, volgende, voorafgaande, absolute en relatieve positionering.
SQLExtendedFetch (cursorbibliotheek) Haalt de opgegeven rijenset op uit de resultatenset. Deze functie is afgeschaft in ODBC 3.x; gebruik SQLFetchScroll in plaats daarvan.
SQLGetData (cursorbibliotheek) Hiermee worden gegevens opgehaald voor één kolom in de resultatenset na SQLFetch of SQLFetchScroll zijn aangeroepen.

Descriptorbewerkingen

Met deze functies worden descriptorveldwaarden opgehaald en ingesteld. Descriptors definiëren de kenmerken van parameters en kolommen in de resultatenset.

Functie Description
SQLGetDescField en SQLGetDescRec (cursorbibliotheek) Afzonderlijke veldwaarden ophalen of volledige descriptorrecords voltooien. De cursorbibliotheek verwerkt deze voor de interne descriptors.
SQLSetDescField en SQLSetDescRec (cursorbibliotheek) Stel afzonderlijke veldwaarden of volledige descriptorrecords in. In de cursorbibliotheek worden wijzigingen in de beschrijvingsvelden bijgehouden.

Query's voor stuurprogrammafuncties

Deze functies retourneren informatie over de mogelijkheden van de stuurprogramma- en cursorbibliotheek.

Functie Description
SQLGetFunctions (cursorbibliotheek) Retourneert informatie over welke ODBC-functies het stuurprogramma ondersteunt. De cursorbibliotheek wijzigt het antwoord om functies op te nemen die worden geïmplementeerd.
SQLGetInfo (cursorbibliotheek) Retourneert algemene informatie over het stuurprogramma en de gegevensbron. De cursorbibliotheek wijzigt bepaalde aan cursor gerelateerde informatietypen om de mogelijkheden ervan weer te geven.

Instructie- en verbindingskenmerken

Met deze functies worden instructie-, verbindings- en omgevingskenmerken opgehaald en ingesteld die van invloed zijn op het gedrag van de cursor.

Functie Description
SQLGetStmtAttr (cursorbibliotheek) Retourneert de huidige waarde van een instructiekenmerk. De cursorbibliotheek verwerkt kenmerken met betrekking tot het gedrag van de cursor.
SQLGetStmtOption (cursorbibliotheek) Retourneert optiewaarden voor instructie. Deze functie is afgeschaft in ODBC 3.x; gebruik SQLGetStmtAttr in plaats daarvan.
SQLSetStmtAttr (cursorbibliotheek) Hiermee stelt u een instructiekenmerk in. De cursorbibliotheek verwerkt cursorgerelateerde kenmerken om schuifbare cursorondersteuning te implementeren.
SQLSetScrollOptions (cursorbibliotheek) Hiermee stelt u opties in waarmee het gedrag van de cursor wordt bepaald. Deze functie is afgeschaft in ODBC 3.x; gebruik SQLSetStmtAttr in plaats daarvan met cursorgerelateerde kenmerken.
SQLSetConnectAttr (cursorbibliotheek) Hiermee stelt u een verbindingskenmerk in. De cursorbibliotheek verwerkt het SQL_ATTR_ODBC_CURSORS kenmerk om het gebruik van cursorbibliotheek in of uit te schakelen.
SQLSetEnvAttr (cursorbibliotheek) Hiermee stelt u een omgevingskenmerk in. De cursorbibliotheek geeft deze aanroep door aan Driver Manager.

SQL-vertaling en rijbewerkingen

Deze functies verwerken vertaling van SQL-instructies en het ophalen van het aantal rijen.

Functie Description
SQLNativeSql (cursorbibliotheek) Retourneert de SQL-tekenreeks zoals gewijzigd door het stuurprogramma. De cursorbibliotheek geeft deze aanroep door aan het stuurprogramma zonder wijziging.
SQLRowCount (cursorbibliotheek) Retourneert het aantal rijen dat wordt beïnvloed door de instructie UPDATE, INSERT of DELETE. De cursorbibliotheek houdt het aantal rijen bij voor positie-update- en verwijderbewerkingen.