Condividi tramite


SQLBindCol (libreria di cursori)

Importante

Questa funzionalità verrà rimossa nelle versioni future di Windows. Evitare di usare questa funzionalità nel nuovo lavoro di sviluppo e pianificare la modifica delle applicazioni che attualmente usano questa funzionalità. Microsoft consiglia di usare la funzionalità cursore del driver.

In questo argomento viene illustrato l'uso della funzione SQLBindCol nella libreria di cursori. Per informazioni generali su SQLBindCol, vedere Funzione SQLBindCol.

Un'applicazione alloca uno o più buffer per la libreria di cursori in cui restituire il set di righe corrente. Chiama SQLBindCol una o più volte per associare questi buffer al set di risultati.

Un'applicazione può chiamare SQLBindCol per riassociare le colonne del set di risultati dopo aver chiamato SQLExtendedFetch, SQLFetch o SQLFetchScroll, purché le cifre di dati, le dimensioni della colonna e le cifre decimali della colonna associata rimangano invariate. L'applicazione non deve chiudere il cursore per riassociare le colonne a indirizzi diversi.

La libreria di cursori supporta l'impostazione dell'attributo di istruzione SQL_ATTR_ROW_BIND_OFFSET_PTR per l'uso degli offset di associazione. Non è necessario chiamare SQLBindCol per eseguire questa riassociazione. Se la libreria di cursori viene utilizzata con un driver ODBC 3.x , l'offset di associazione non viene utilizzato quando viene chiamato SQLFetch . L'offset di associazione viene usato se SQLFetch viene chiamato quando viene usata la libreria di cursori con un driver ODBC 2.x perché SQLFetch viene quindi mappato a SQLExtendedFetch.

La libreria di cursori supporta la chiamata a SQLBindCol per associare la colonna del segnalibro.

Quando si utilizza un driver ODBC 2.x , la libreria di cursori restituisce SQLSTATE HY090 (stringa o lunghezza buffer non valida) quando VIENE chiamato SQLBindCol per impostare la lunghezza del buffer per una colonna di segnalibro su un valore diverso da 4. Quando si utilizza un driver ODBC 3.x , la libreria di cursori consente al buffer di essere qualsiasi dimensione.