Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Si applica a:
SQL Server, Database SQL di Azure e Istanza gestita di SQL di Azure.
Importante
Questa funzionalità verrà rimossa in una versione futura 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.
La libreria di cursori ODBC offre il supporto del cursore scorrevole per i driver ODBC 2.x che supportano solo cursori forward-only. Quando si abilita la libreria di cursori per una connessione, Gestione driver intercetta le chiamate di funzione e le instrada attraverso la libreria di cursori anziché direttamente al driver. La libreria di cursori esegue la funzione stessa o la passa al driver sottostante.
Funzioni eseguite dalla libreria di cursori
Questi articoli descrivono le funzioni ODBC gestite dalla libreria di cursori e le quali passano al driver.
| Article | Description |
|---|---|
| Funzioni ODBC eseguite dalla libreria di cursori | Elenca le funzioni implementate dalla libreria di cursori per fornire funzionalità di cursore scorrevoli. |
| Funzioni ODBC non eseguite dalla libreria di cursori | Elenca le funzioni passate dalla libreria di cursori al driver senza modifiche. |
Associazione di colonne e parametri
Queste funzioni gestiscono l'associazione dei buffer dell'applicazione alle colonne del set di risultati e ai parametri delle istruzioni. La libreria di cursori modifica il comportamento per supportare gli aggiornamenti posizionati e i cursori di blocco.
| Funzione | Description |
|---|---|
| SQLBindCol (libreria di cursori) | Associa i buffer dell'applicazione alle colonne del set di risultati. La libreria di cursori tiene traccia delle associazioni per supportare operazioni di aggiornamento ed eliminazione posizionate. |
| SQLBindParameter (libreria di cursori) | Associa i buffer dell'applicazione ai marcatori di parametro. La libreria di cursori passa questa chiamata al driver. |
Operazioni bulk e posizionate
Queste funzioni eseguono operazioni bulk su set di righe e aggiornamenti posizionati su singole righe all'interno del set di righe corrente di un cursore.
| Funzione | Description |
|---|---|
| SQLBulkOperations (libreria di cursori) | Esegue operazioni di inserimento bulk, aggiornamento, eliminazione o recupero tramite segnalibro. La libreria di cursori esegue il mapping a SQLSetPos quando si utilizzano driver ODBC 2.x. |
| SQLSetPos (libreria di cursori) | Posiziona il cursore all'interno di un set di righe e consente alle applicazioni di aggiornare, aggiornare o eliminare dati nel set di righe. |
Gestione e transazioni del cursore
Queste funzioni gestiscono la durata del cursore e i limiti delle transazioni.
| Funzione | Description |
|---|---|
| SQLCloseCursor (libreria di cursori) | Chiude un cursore su un'istruzione e rimuove i risultati in sospeso. |
| SQLEndTran (libreria di cursori) | Esegue il commit o il rollback di una transazione. La libreria di cursori gestisce lo stato del cursore attraverso i limiti delle transazioni in base alle SQL_CURSOR_COMMIT_BEHAVIOR impostazioni e SQL_CURSOR_ROLLBACK_BEHAVIOR . |
| SQLFreeStmt (libreria di cursori) | Arresta l'elaborazione delle istruzioni, chiude qualsiasi cursore associato, elimina i risultati in sospeso e, facoltativamente, libera tutte le risorse associate all'handle di istruzione. |
Recupero dei dati
Queste funzioni recuperano i dati dai set di risultati. La libreria di cursori offre funzionalità di cursore scorrevoli per i driver che supportano solo cursori forward-only.
| Funzione | Description |
|---|---|
| SQLFetch (libreria di cursori) | Recupera il set di righe successivo di dati dal set di risultati. Quando si utilizzano driver ODBC 2.x, la libreria di cursori esegue il mapping a SQLExtendedFetch. |
| SQLFetchScroll (libreria di cursori) | Recupera il set di righe di dati specificato dal set di risultati e restituisce i dati per tutte le colonne associate. Supporta varie direzioni di scorrimento, tra cui first, last, next, prior, absolute e relative positioning. |
| SQLExtendedFetch (libreria di cursori) | Recupera il set di righe specificato dal set di risultati. Questa funzione è deprecata in ODBC 3.x; usare SQLFetchScroll invece . |
| SQLGetData (libreria di cursori) | Recupera i dati per una singola colonna nel set di risultati dopo SQLFetch o SQLFetchScroll è stato chiamato . |
Operazioni del descrittore
Queste funzioni ottengono e impostano i valori dei campi del descrittore. I descrittori definiscono gli attributi dei parametri e delle colonne del set di risultati.
| Funzione | Description |
|---|---|
| SQLGetDescField e SQLGetDescRec (libreria di cursori) | Recuperare i singoli valori di campo o i record del descrittore completo. La libreria di cursori gestisce questi elementi per i descrittori interni. |
| SQLSetDescField e SQLSetDescRec (libreria di cursori) | Impostare i singoli valori di campo o i record del descrittore completo. La libreria di cursori tiene traccia delle modifiche apportate ai campi del descrittore. |
Query sulle funzionalità del driver
Queste funzioni restituiscono informazioni sulle funzionalità del driver e della libreria di cursori.
| Funzione | Description |
|---|---|
| SQLGetFunctions (libreria di cursori) | Restituisce informazioni sulle funzioni ODBC supportate dal driver. La libreria di cursori modifica la risposta in modo da includere le funzioni implementate. |
| SQLGetInfo (libreria di cursori) | Restituisce informazioni generali sul driver e sull'origine dati. La libreria di cursori modifica determinati tipi di informazioni correlati al cursore in modo da riflettere le relative funzionalità. |
Attributi di istruzione e connessione
Queste funzioni ottengono e impostano attributi di istruzione, connessione e ambiente che influiscono sul comportamento del cursore.
| Funzione | Description |
|---|---|
| SQLGetStmtAttr (libreria di cursori) | Restituisce il valore corrente di un attributo di istruzione. La libreria di cursori gestisce gli attributi correlati al comportamento del cursore. |
| SQLGetStmtOption (libreria di cursori) | Restituisce i valori delle opzioni dell'istruzione. Questa funzione è deprecata in ODBC 3.x; usare SQLGetStmtAttr invece . |
| SQLSetStmtAttr (libreria di cursori) | Imposta un attributo di istruzione. La libreria di cursori elabora gli attributi correlati al cursore per implementare il supporto del cursore scorrevole. |
| SQLSetScrollOptions (libreria di cursori) | Imposta le opzioni che controllano il comportamento del cursore. Questa funzione è deprecata in ODBC 3.x; usare SQLSetStmtAttr con attributi correlati al cursore. |
| SQLSetConnectAttr (libreria di cursori) | Imposta un attributo di connessione. La libreria di cursori elabora l'attributo per abilitare o disabilitare l'uso SQL_ATTR_ODBC_CURSORS della libreria di cursori. |
| SQLSetEnvAttr (libreria di cursori) | Imposta un attributo di ambiente. La libreria di cursori passa questa chiamata a Gestione driver. |
Operazioni di traduzione e riga di SQL
Queste funzioni gestiscono la conversione delle istruzioni SQL e il recupero del conteggio delle righe.
| Funzione | Description |
|---|---|
| SQLNativeSql (libreria di cursori) | Restituisce la stringa SQL modificata dal driver. La libreria di cursori passa questa chiamata al driver senza modifiche. |
| SQLRowCount (libreria di cursori) | Restituisce il numero di righe interessate da un'istruzione UPDATE, INSERT o DELETE. La libreria di cursori tiene traccia dei conteggi delle righe per le operazioni di aggiornamento ed eliminazione posizionate. |