Freigeben über


SQLSetStmtAttr (Cursorbibliothek)

Wichtig

Dieses Feature wird in einer zukünftigen Version von Windows entfernt. Vermeiden Sie die Verwendung dieses Features in neuen Entwicklungsvorgängen, und planen Sie, Anwendungen zu ändern, die dieses Feature derzeit verwenden. Microsoft empfiehlt die Verwendung der Cursorfunktion des Treibers.

In diesem Thema wird die Verwendung der FUNKTION SQLSetStmtAttr in der Cursorbibliothek erläutert. Allgemeine Informationen zu SQLSetStmtAttr finden Sie unter SQLSetStmtAttr-Funktion.

Die Cursorbibliothek unterstützt die folgenden Anweisungsattribute mit SQLSetStmtAttr:

SQL_ATTR_CONCURRENCY
SQL_ATTR_CURSOR_TYPE
SQL_ATTR_FETCH_BOOKMARK_PTR
SQL_ATTR_PARAM_BIND_OFFSET_PTR
SQL_ATTR_PARAM_BIND_TYPE

SQL_ATTR_ROW_BIND_OFFSET_PTR
SQL_ATTR_ROW_BIND_TYPE
SQL_ATTR_ROWSET_ARRAY_SIZE
SQL_ATTR_SIMULATE_CURSOR
SQL_ATTR_USE_BOOKMARKS

Die Cursorbibliothek unterstützt nur die SQL_CURSOR_FORWARD_ONLY- und SQL_CURSOR_STATIC-Werte des attributs SQL_ATTR_CURSOR_TYPE-Anweisung.

Bei vorwärtsgerichteten Cursorn unterstützt die Cursorbibliothek den SQL_CONCUR_READ_ONLY Wert des attributs SQL_ATTR_CONCURRENCY-Anweisung. Bei statischen Cursorn unterstützt die Cursorbibliothek die SQL_CONCUR_READ_ONLY- und SQL_CONCUR_VALUES-Werte des SQL_ATTR_CONCURRENCY-Anweisungsattributs.

Die Cursorbibliothek unterstützt nur den SQL_SC_NON_UNIQUE Wert des attributs SQL_ATTR_SIMULATE_CURSOR-Anweisung.

Obwohl die ODBC-Spezifikation Aufrufe von SQLSetStmtAttr mit den Attributen SQL_ATTR_PARAM_BIND_TYPE oder SQL_ATTR_ROW_BIND_TYPE unterstützt, nachdem SQLFetch oder SQLFetchScroll aufgerufen wurde, ist die Cursorbibliothek dies nicht. Bevor sie den Bindungstyp in der Cursorbibliothek ändern kann, muss die Anwendung den Cursor schließen. Die Cursorbibliothek unterstützt das Ändern der SQL_ATTR_ROW_BIND_OFFSET_PTR-, SQL_ATTR_PARAM_BIND_OFFSET_PTR-, SQL_ATTR_ROWS_FETCHED_PTR- und SQL_ATTR_PARAMS_PROCESSED_PTR-Anweisungsattribute, wenn ein Cursor geöffnet ist.

Eine Anwendung kann SQLSetStmtAttr mit einem Attribut von SQL_ATTR_ROW_ARRAY_SIZE aufrufen, um die Rowsetgröße zu ändern, während ein Cursor geöffnet ist. Die neue Rowsetgröße wird beim nächsten Aufruf von SQLFetchScroll oder SQLFetch wirksam.

Die Cursorbibliothek unterstützt das Festlegen des SQL_ATTR_PARAM_BIND_OFFSET_PTR- oder SQL_ATTR_ROW_BIND_OFFSET_PTR-Anweisungsattributs, um Bindungsoffsets zu aktivieren. Der Bindungsoffset wird nicht für Aufrufe von SQLFetch verwendet, wenn die Cursorbibliothek mit ODBC 2 verwendet wird. x-Treiber .

Die Cursorbibliothek unterstützt das Festlegen des Attributs SQL_ATTR_USE_BOOKMARKS-Anweisung auf SQL_UB_VARIABLE.