Freigeben über


SQLSetConnectAttr (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 das Ändern von Anwendungen, die dieses Feature derzeit verwenden. Microsoft empfiehlt die Verwendung der Cursorfunktion des Treibers.

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

Eine Anwendung ruft SQLSetConnectAttr mit dem attribut SQL_ATTR_ODBC_CURSORS auf, um anzugeben, ob die Cursorbibliothek immer verwendet wird, wenn der Treiber keine bildlauffähigen Cursor unterstützt oder nie verwendet wird. Die Cursorbibliothek geht davon aus, dass ein Treiber scrollbare Cursor unterstützt, wenn er SQL_CA1_RELATIVE für den SQL_STATIC_CURSOR_ATTRIBUTES1 Informationstyp in SQLGetInfo zurückgibt.

Die Anwendung muss SQLSetConnectAttr aufrufen, um die Verwendung der Cursorbibliothek anzugeben, nachdem SQLAllocHandle mit einem HandleType von SQL_HANDLE_DBC aufgerufen wird, um die Verbindung zuzuordnen und bevor eine Verbindung mit der Datenquelle hergestellt wird. Wenn eine Anwendung SQLSetConnectAttr mit dem attribut SQL_ATTR_ODBC_CURSORS aufruft, während die Verbindung noch aktiv ist, gibt die Cursorbibliothek einen Fehler zurück.

Um ein Anweisungsattribut festzulegen, das von der Cursorbibliothek für alle einer Verbindung zugeordneten Anweisungen unterstützt wird, muss eine Anwendung SQLSetConnectAttr für dieses Anweisungsattribut aufrufen, nachdem sie eine Verbindung mit der Datenquelle hergestellt hat und bevor der Cursor geöffnet wird. Wenn eine Anwendung SQLSetConnectAttr mit einem Anweisungsattribut aufruft und ein Cursor für eine Anweisung geöffnet ist, die der Verbindung zugeordnet ist, wird das Anweisungsattribut erst dann auf diese Anweisung angewendet, wenn der Cursor geschlossen und erneut geöffnet wird.