Condividi tramite


SQLSetStmtAttr (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 SQLSetStmtAttr nella libreria di cursori. Per informazioni generali su SQLSetStmtAttr, vedere Funzione SQLSetStmtAttr.

La libreria di cursori supporta gli attributi di istruzione seguenti con 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

La libreria di cursori supporta solo i valori SQL_CURSOR_FORWARD_ONLY e SQL_CURSOR_STATIC dell'attributo dell'istruzione SQL_ATTR_CURSOR_TYPE.

Per i cursori forward-only, la libreria di cursori supporta il valore SQL_CONCUR_READ_ONLY dell'attributo dell'istruzione SQL_ATTR_CONCURRENCY. Per i cursori statici, la libreria di cursori supporta i valori SQL_CONCUR_READ_ONLY e SQL_CONCUR_VALUES dell'attributo dell'istruzione SQL_ATTR_CONCURRENCY.

La libreria di cursori supporta solo il valore SQL_SC_NON_UNIQUE dell'attributo dell'istruzione SQL_ATTR_SIMULATE_CURSOR.

Sebbene la specifica ODBC supporti le chiamate a SQLSetStmtAttr con gli attributi SQL_ATTR_PARAM_BIND_TYPE o SQL_ATTR_ROW_BIND_TYPE dopo la chiamata di SQLFetch o SQLFetchScroll, la libreria di cursori non viene chiamata. Prima di poter modificare il tipo di associazione nella libreria di cursori, l'applicazione deve chiudere il cursore. La libreria di cursori supporta la modifica degli attributi di istruzione SQL_ATTR_ROW_BIND_OFFSET_PTR, SQL_ATTR_PARAM_BIND_OFFSET_PTR, SQL_ATTR_ROWS_FETCHED_PTR e SQL_ATTR_PARAMS_PROCESSED_PTR quando un cursore è aperto.

Un'applicazione può chiamare SQLSetStmtAttr con un attributo di SQL_ATTR_ROW_ARRAY_SIZE per modificare le dimensioni del set di righe mentre un cursore è aperto. La nuova dimensione del set di righe avrà effetto alla successiva chiamata di SQLFetchScroll o SQLFetch .

La libreria di cursori supporta l'impostazione dell'attributo di istruzione SQL_ATTR_PARAM_BIND_OFFSET_PTR o SQL_ATTR_ROW_BIND_OFFSET_PTR per abilitare gli offset di associazione. L'offset di associazione non verrà utilizzato per le chiamate a SQLFetch quando la libreria di cursori viene utilizzata con ODBC 2.x driver.

La libreria di cursori supporta l'impostazione dell'attributo dell'istruzione SQL_ATTR_USE_BOOKMARKS su SQL_UB_VARIABLE.