Freigeben über

SQLBindCol (Cursorbibliothek)

  • Artikel

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 SQLBindCol in der Cursorbibliothek erläutert. Allgemeine Informationen zu SQLBindCol finden Sie unter SQLBindCol-Funktion.

Eine Anwendung weist einen oder mehrere Puffer für die Cursorbibliothek zu, um das aktuelle Rowset zurückzugeben. SqlBindCol wird mehrmals aufgerufen, um diese Puffer an das Resultset zu binden.

Eine Anwendung kann SQLBindCol aufrufen, um Resultsetspalten neu zu binden, nachdem sqlExtendedFetch, SQLFetch oder SQLFetchScroll aufgerufen wurde, solange der C-Datentyp, die Spaltengröße und die Dezimalstellen der gebundenen Spalte gleich bleiben. Die Anwendung muss den Cursor nicht schließen, um Spalten an verschiedene Adressen neu zu binden.

Die Cursorbibliothek unterstützt das Festlegen des SQL_ATTR_ROW_BIND_OFFSET_PTR-Anweisungsattributs, um Bindungsoffsets zu verwenden. (SQLBindCol muss nicht aufgerufen werden, damit diese erneute Bindung erfolgt.) Wenn die Cursorbibliothek mit einem ODBC 3.x-Treiber verwendet wird, wird der Bindungsoffset nicht verwendet, wenn SQLFetch aufgerufen wird. Der Bindungsoffset wird verwendet, wenn SQLFetch aufgerufen wird, wenn die Cursorbibliothek mit einem ODBC 2.x-Treiber verwendet wird, da SQLFetch dann SQLExtendedFetch zugeordnet wird.

Die Cursorbibliothek unterstützt das Aufrufen von SQLBindCol , um die Lesezeichenspalte zu binden.

Wenn Sie mit einem ODBC 2.x-Treiber arbeiten, gibt die Cursorbibliothek SQLSTATE HY090 (Ungültige Zeichenfolgen- oder Pufferlänge) zurück, wenn SQLBindCol aufgerufen wird, um die Pufferlänge für eine Lesezeichenspalte auf einen Wert ungleich 4 festzulegen. Wenn Sie mit einem ODBC 3.x-Treiber arbeiten, lässt die Cursorbibliothek zu, dass der Puffer eine beliebige Größe hat.