De ODBC Cursor-bibliotheek gebruiken

Important

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.

Om de ODBC-cursorbibliotheek te gebruiken, is een applicatie:

  1. Roept SQLSetConnectAttr aan met een attribuut van SQL_ATTR_ODBC_CURSORS om aan te geven hoe de cursorbibliotheek met een bepaalde verbinding moet worden gebruikt. De cursorbibliotheek kan altijd worden gebruikt (SQL_CUR_USE_ODBC), alleen worden gebruikt als de driver geen scrollbare cursors ondersteunt (SQL_CUR_USE_IF_NEEDED), of nooit gebruikt (SQL_CUR_USE_DRIVER).

  2. Roept SQLConnect, SQLDriverConnect of SQLBrowseConnect aan om verbinding te maken met de databron.

  3. Roept SQLSetStmtAttr aan om het cursortype (SQL_ATTR_CURSOR_TYPE), gelijktijdigheid (SQL_ATTR_CONCURRENCY) en rijsetgrootte (SQL_ATTR_ROW_ARRAY_SIZE) te specificeren. De cursorbibliotheek ondersteunt forward-only en statische cursors. Forward-only cursors moeten alleen-lezen zijn, terwijl statische cursors alleen-lezen kunnen zijn of positieve gelijktijdigheidscontrole kunnen gebruiken om waarden te vergelijken.

  4. Wijst één of meer rowsetbuffers toe en roept SQLBindCol één of meer keren aan om deze buffers aan de kolommen van de resultaatset te binden.

  5. Genereert een resultaatset door een SELECT-instructie of procedure uit te voeren, of door een catalogusfunctie aan te roepen. Als de applicatie gepositioneerde update-instructies uitvoert, moet deze een SELECT FOR-instructie UPDATE uitvoeren om de resultaatset te genereren.

  6. Roept SQLFetch of SQLFetchScroll één of meerdere keren aan om door de resultaatset te scrollen.

De applicatie kan datawaarden wijzigen in de rowset-buffers. Om de rowset-buffers te verversen met gegevens uit de cache van de cursorbibliotheek, roept een applicatie SQLFetchScroll aan met het FetchOrientation-argument op SQL_FETCH_RELATIVE en het FetchOffset-argument op 0.

Om gegevens op te halen uit een niet-gebonden kolom, roept de applicatie SQLSetPos aan om de cursor op de gewenste rij te positioneren. Vervolgens roept het SQLGetData aan om de data op te halen.

Om het aantal rijen te bepalen dat uit de databron is gehaald, roept de applicatie SQLRowCount aan.