Funzione SQLBrowseConnect
Conformità
Versione introdotta: Conformità agli standard ODBC 1.0: ODBC
Riepilogo
SQLBrowseConnect supporta un metodo iterativo per individuare ed enumerare gli attributi e i valori degli attributi necessari per connettersi a un'origine dati. Ogni chiamata a SQLBrowseConnect restituisce livelli successivi di attributi e valori di attributo. Quando tutti i livelli sono stati enumerati, viene completata una connessione all'origine dati e viene restituita una stringa di connessione completa da SQLBrowseConnect. Un codice restituito di SQL_SUCCESS o SQL_SUCCESS_WITH_INFO indica che tutte le informazioni di connessione sono state specificate e l'applicazione è ora connessa all'origine dati.
Sintassi
SQLRETURN SQLBrowseConnect(
SQLHDBC ConnectionHandle,
SQLCHAR * InConnectionString,
SQLSMALLINT StringLength1,
SQLCHAR * OutConnectionString,
SQLSMALLINT BufferLength,
SQLSMALLINT * StringLength2Ptr);
Argomenti
ConnectionHandle
[Input] Handle di connessione.
InConnectionString
[Input] Sfogliare la stringa di connessione della richiesta (vedere "Argomento InConnectionString " in "Comments").
StringLength1
[Input] Lunghezza di *InConnectionString in caratteri.
OutConnectionString
[Output] Puntatore a un buffer di caratteri in cui restituire la stringa di connessione del risultato sfoglia (vedere "Argomento OutConnectionString " in "Comments").
Se OutConnectionString è NULL, StringLength2Ptr restituirà comunque il numero totale di caratteri (escluso il carattere di terminazione Null per i dati di tipo carattere) da restituire nel buffer a cui punta OutConnectionString.
BufferLength
[Input] Lunghezza, in caratteri, del buffer *OutConnectionString .
StringLength2Ptr
[Output] Numero totale di caratteri (escluso terminazione null) disponibile per la restituzione in *OutConnectionString. Se il numero di caratteri disponibili per la restituzione è maggiore o uguale a BufferLength, la stringa di connessione in *OutConnectionString viene troncata a BufferLength meno la lunghezza di un carattere di terminazione Null.
Resi
SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_NEED_DATA, SQL_ERROR, SQL_INVALID_HANDLE o SQL_STILL_EXECUTING.
Diagnostica
Quando SQLBrowseConnect restituisce SQL_ERROR, SQL_SUCCESS_WITH_INFO o SQL_NEED_DATA, è possibile ottenere un valore SQLSTATE associato chiamando SQLGetDiagRec con handleType di SQL_HANDLE_STMT e handle di ConnectionHandle. La tabella seguente elenca i valori SQLSTATE comunemente restituiti da SQLBrowseConnect e spiega ognuno di essi nel contesto di questa funzione. La notazione "(DM)" precede le descrizioni di SQLSTATEs restituite da Gestione driver. Il codice restituito associato a ogni valore SQLSTATE è SQL_ERROR, a meno che non sia specificato diversamente.
| SQLSTATE | Errore | Descrizione |
|---|---|---|
| 01000 | Avviso generale | Messaggio informativo specifico del driver. (La funzione restituisce SQL_SUCCESS_WITH_INFO. |
| 01004 | Dati stringa, troncati a destra | Il buffer *OutConnectionString non è sufficientemente grande da restituire l'intera stringa di connessione del risultato di esplorazione, quindi la stringa è stata troncata. Il buffer *StringLength2Ptr contiene la lunghezza della stringa di connessione dei risultati di esplorazione non troncata. (La funzione restituisce SQL_NEED_DATA. |
| 01S00 | Attributo della stringa di connessione non valido | Una parola chiave di attributo non valida è stata specificata nella stringa di connessione della richiesta di esplorazione (InConnectionString). (La funzione restituisce SQL_NEED_DATA. Una parola chiave attribute è stata specificata nella stringa di connessione della richiesta di esplorazione (InConnectionString) che non si applica al livello di connessione corrente. (La funzione restituisce SQL_NEED_DATA. |
| 01S02 | Valore modificato | Il driver non supporta il valore specificato dell'argomento ValuePtr in SQLSetConnectAttr e ha sostituito un valore simile. (La funzione restituisce SQL_SUCCESS_WITH_INFO. |
| 08001 | Il client non è in grado di stabilire la connessione | Il driver non è riuscito a stabilire una connessione con l'origine dati. |
| 08002 | Nome connessione in uso | (DM) La connessione specificata era già stata usata per stabilire una connessione con un'origine dati e la connessione era aperta. |
| 08004 | Il server ha rifiutato la connessione | L'origine dati ha rifiutato la creazione della connessione per motivi definiti dall'implementazione. |
| 08S01 | Errore del collegamento di comunicazione | Collegamento di comunicazione tra il driver e l'origine dati a cui il driver stava tentando di connettersi non è riuscito prima del completamento dell'elaborazione della funzione. |
| 28000 | Specifica di autorizzazione non valida | L'identificatore utente o la stringa di autorizzazione o entrambi, come specificato nella stringa di connessione della richiesta di esplorazione (InConnectionString), viola le restrizioni definite dall'origine dati. |
| HY000 | Errore generale: | Si è verificato un errore per il quale non è stato specificato SQLSTATE e per il quale non è stato definito alcun SQLSTATE specifico dell'implementazione. Il messaggio di errore restituito da SQLGetDiagRec nel buffer *MessageText descrive l'errore e la relativa causa. |
| HY001 | Errore di allocazione della memoria | (DM) Gestione driver non è riuscito ad allocare memoria necessaria per supportare l'esecuzione o il completamento della funzione. Il driver non è riuscito ad allocare memoria necessaria per supportare l'esecuzione o il completamento della funzione. |
| HY008 | Operazione annullata | Un'operazione asincrona è stata annullata chiamando la funzione SQLCancelHandle. Quindi, la funzione originale è stata chiamata di nuovo in ConnectionHandle. Un'operazione è stata annullata chiamando SQLCancelHandle in ConnectionHandle da un thread diverso in un'applicazione multithread. |
| HY010 | Errore della sequenza di funzioni | (DM) Una funzione in esecuzione asincrona (non questa) è stata chiamata per ConnectionHandle ed era ancora in esecuzione quando questa funzione è stata chiamata. |
| HY013 | Errore di gestione della memoria | Impossibile elaborare la chiamata di funzione perché non è stato possibile accedere agli oggetti di memoria sottostanti, probabilmente a causa di condizioni di memoria insufficiente. |
| HY090 | Lunghezza della stringa o del buffer non valida | (DM) Il valore specificato per l'argomento StringLength1 è minore di 0 e non è uguale a SQL_NTS. (DM) Il valore specificato per l'argomento BufferLength è minore di 0. |
| HY114 | Il driver non supporta l'esecuzione asincrona a livello di connessione | (DM) L'applicazione ha abilitato l'operazione asincrona sull'handle di connessione prima di stabilire la connessione. Tuttavia, il driver non supporta l'operazione asincrona nell'handle di connessione. |
| HYT00 | Timeout scaduto | Periodo di timeout di accesso scaduto prima del completamento della connessione all'origine dati. Il periodo di timeout viene impostato tramite SQLSetConnectAttr, SQL_ATTR_LOGIN_TIMEOUT. |
| HYT01 | Il timeout della connessione è scaduto | Periodo di timeout della connessione scaduto prima che l'origine dati rispondesse alla richiesta. Il periodo di timeout della connessione viene impostato tramite SQLSetConnectAttr, SQL_ATTR_CONNECTION_TIMEOUT. |
| IM001 | Il driver non supporta questa funzione | (DM) Il driver corrispondente al nome dell'origine dati specificato non supporta la funzione. |
| IM002 | Origine dati non trovata e nessun driver predefinito specificato | (DM) Il nome dell'origine dati specificato nella stringa di connessione della richiesta di esplorazione (InConnectionString) non è stato trovato nelle informazioni di sistema, né esiste una specifica del driver predefinita. (DM) Impossibile trovare informazioni sull'origine dati ODBC e sul driver predefinito nelle informazioni di sistema. |
| IM003 | Impossibile caricare il driver specificato | (DM) Il driver elencato nella specifica dell'origine dati nelle informazioni di sistema o specificato dalla parola chiave DRIVER non è stato trovato o non è stato possibile caricare per qualche altro motivo. |
| IM004 | SQLAllocHandle del driver in SQL_HANDLE _ENV non riuscito | (DM) Durante SQLBrowseConnect, Gestione driver ha chiamato la funzione SQLAllocHandle del driver con handleType di SQL_HANDLE_ENV e il driver ha restituito un errore. |
| IM005 | SQLAllocHandle del driver in SQL_HANDLE_DBC non riuscito | (DM) Durante SQLBrowseConnect, Gestione driver ha chiamato la funzione SQLAllocHandle del driver con handleType di SQL_HANDLE_DBC e il driver ha restituito un errore. |
| IM006 | SqlSetConnectAttr del driver non riuscito | (DM) Durante SQLBrowseConnect, Gestione driver ha chiamato la funzione SQLSetConnectAttr del driver e il driver ha restituito un errore. |
| IM009 | Impossibile caricare la DLL di traduzione | Il driver non è riuscito a caricare la DLL di conversione specificata per l'origine dati o per la connessione. |
| IM010 | Nome origine dati troppo lungo | (DM) Il valore dell'attributo per la parola chiave DSN è maggiore di SQL_MAX_DSN_LENGTH caratteri. |
| IM011 | Nome driver troppo lungo | (DM) Il valore dell'attributo per la parola chiave DRIVER è maggiore di 255 caratteri. |
| IM012 | Errore di sintassi delle parole chiave DRIVER | (DM) La coppia di parole chiave-valore per la parola chiave DRIVER contiene un errore di sintassi. |
| IM014 | Il DSN specificato contiene una mancata corrispondenza dell'architettura tra il driver e l'applicazione | (DM) un'applicazione a 32 bit usa un DSN che si connette a un driver a 64 bit; o viceversa. |
| IM017 | Il polling è disabilitato in modalità di notifica asincrona | Ogni volta che viene usato il modello di notifica, il polling è disabilitato. |
| IM018 | SQLCompleteAsync non è stato chiamato per completare l'operazione asincrona precedente su questo handle. | Se la chiamata di funzione precedente sull'handle restituisce SQL_STILL_EXECUTING e se la modalità di notifica è abilitata, è necessario chiamare SQLCompleteAsync sull'handle per eseguire la post-elaborazione e completare l'operazione. |
| S1118 | Il driver non supporta la notifica asincrona | Quando il driver non supporta la notifica asincrona, non è possibile impostare SQL_ATTR_ASYNC_DBC_EVENT o SQL_ATTR_ASYNC_DBC_RETCODE_PTR. |
Argomento InConnectionString
Una stringa di connessione della richiesta di esplorazione ha la sintassi seguente:
connection-string ::= attribute[;] | attributo;stringa di connessione;
attribute ::= attribute-keyword=attribute-valueDRIVER= | [{]attribute-value[}]
attribute-keyword ::= DSNPWD | UID | | driver-defined-attribute-keyword
attribute-value ::= character-string
identificatore driver-defined-attribute-keyword ::=
dove la stringa di caratteri ha zero o più caratteri; l'identificatore ha uno o più caratteri; attribute-keyword non fa distinzione tra maiuscole e minuscole; attribute-value può fare distinzione tra maiuscole e minuscole e il valore della parola chiave DSN non è costituito esclusivamente da spazi vuoti. A causa della grammatica dei file di inizializzazione e della stringa di connessione, parole chiave e valori di attributo che contengono i caratteri []{}(),;? *=!@ deve essere evitato. A causa della grammatica nelle informazioni di sistema, le parole chiave e i nomi delle origini dati non possono contenere il carattere barra rovesciata (\). Per odbc 2.X driver, le parentesi graffe sono necessarie intorno al valore dell'attributo per la parola chiave DRIVER.
Se nella stringa di connessione della richiesta di esplorazione vengono ripetute parole chiave, il driver usa il valore associato alla prima occorrenza della parola chiave. Se le parole chiave DSN e DRIVER sono incluse nella stessa stringa di connessione della richiesta di esplorazione, gestione driver e driver usano la parola chiave che viene visualizzata per prima.
Per informazioni su come un'applicazione sceglie un'origine dati o un driver, vedere Scelta di un'origine dati o di un driver.
Argomento OutConnectionString
La stringa di connessione del risultato di esplorazione è un elenco di attributi di connessione. Un attributo di connessione è costituito da una parola chiave attribute e da un valore di attributo corrispondente. La stringa di connessione del risultato sfoglia ha la sintassi seguente:
connection-string ::= attribute[;] | attributo;connection-string
attribute ::= [*]attribute-keyword=attribute-value
attribute-keyword ::= ODBC-attribute-keyword | driver-defined-attribute-keyword
ODBC-attribute-keyword = {UIDPWD | }[:localized-identifier] driver-defined-attribute-keyword ::= identifier[:localized-identifier] attribute-value ::= {attribute-value-list | }? (le parentesi graffe sono letterali; vengono restituite dal driver).
attribute-value-list ::= character-string [:stringa di caratteri localizzata] | character-string [:localized-character string] ,attribute-value-list
dove la stringa di caratteri e la stringa di caratteri localizzati hanno zero o più caratteri; identificatore e identificatore localizzato hanno uno o più caratteri; attribute-keyword non fa distinzione tra maiuscole e minuscole e attribute-value può fare distinzione tra maiuscole e minuscole. A causa della grammatica dei file di inizializzazione e della stringa di connessione, delle parole chiave, degli identificatori localizzati e dei valori di attributo che contengono i caratteri []{}(),;? *=!@ deve essere evitato. A causa della grammatica nelle informazioni di sistema, le parole chiave e i nomi delle origini dati non possono contenere il carattere barra rovesciata (\).
La sintassi della stringa di connessione dei risultati di esplorazione viene usata in base alle regole semantiche seguenti:
Se un asterisco (*) precede una parola chiave attribute, l'attributoè facoltativo e può essere omesso nella chiamata successiva a SQLBrowseConnect.
Le parole chiave dell'attributo UID e PWD hanno lo stesso significato definito in SQLDriverConnect.
Un driver-defined-attribute-keyword assegna un nome al tipo di attributo per il quale è possibile specificare un valore di attributo. Ad esempio, potrebbe trattarsi di SERVER, DATABASE, HOST o DBMS.
ODBC-attribute-keywords e driver-defined-attribute-keywords includono una versione localizzata o intuitiva della parola chiave. Può essere usato dalle applicazioni come etichetta in una finestra di dialogo. Tuttavia, è necessario usare solo UID, PWD o l'identificatore quando si passa una stringa di richiesta di esplorazione al driver.
{attribute-value-list} è un'enumerazione dei valori effettivi validi per la parola chiave attribute-keyword corrispondente. Si noti che le parentesi graffe ({}) non indicano un elenco di scelte, ma vengono restituite dal driver. Ad esempio, potrebbe trattarsi di un elenco di nomi di server o di un elenco di nomi di database.
Se il valore dell'attributo è un singolo punto interrogativo (?), un singolo valore corrisponde alla parola chiave attribute. Ad esempio, UID=JohnS; PWD=Sesame.
Ogni chiamata a SQLBrowseConnect restituisce solo le informazioni necessarie per soddisfare il livello successivo del processo di connessione. Il driver associa le informazioni sullo stato all'handle di connessione in modo che il contesto possa essere sempre determinato in ogni chiamata.
Uso di SQLBrowseConnect
SQLBrowseConnect richiede una connessione allocata. Gestione driver carica il driver specificato in o che corrisponde al nome dell'origine dati specificato nella stringa di connessione della richiesta di esplorazione iniziale; per informazioni su quando si verifica questa situazione, vedere la sezione "Comments" in SQLConnect Function.For information about when this occurs, see the "Comments" section in SQLConnect Function. Il driver può stabilire una connessione con l'origine dati durante il processo di esplorazione. Se SQLBrowseConnect restituisce SQL_ERROR, le connessioni in sospeso vengono terminate e la connessione viene restituita a uno stato non connesso.
Nota
SQLBrowseConnect non supporta il pool di connessioni. Se SQLBrowseConnect viene chiamato durante l'abilitazione del pool di connessioni, verrà restituito SQLSTATE HY000 (errore generale).
Quando SQLBrowseConnect viene chiamato per la prima volta in una connessione, la stringa di connessione della richiesta di esplorazione deve contenere la parola chiave DSN o la parola chiave DRIVER . Se la stringa di connessione della richiesta di esplorazione contiene la parola chiave DSN , Gestione driver individua una specifica dell'origine dati corrispondente nelle informazioni di sistema:
Se Gestione driver trova la specifica dell'origine dati corrispondente, carica la DLL del driver associata; il driver può recuperare informazioni sull'origine dati dalle informazioni di sistema.
Se Gestione driver non riesce a trovare la specifica dell'origine dati corrispondente, individua la specifica dell'origine dati predefinita e carica la DLL del driver associata; il driver può recuperare informazioni sull'origine dati predefinita dalle informazioni di sistema. "DEFAULT" viene passato al driver per il DSN.
Se Gestione driver non riesce a trovare la specifica dell'origine dati corrispondente e non esiste alcuna specifica dell'origine dati predefinita, restituisce SQL_ERROR con SQLSTATE IM002 (origine dati non trovata e nessun driver predefinito specificato).
Se la stringa di connessione della richiesta di esplorazione contiene la parola chiave DRIVER , Gestione driver carica il driver specificato e non tenta di individuare un'origine dati nelle informazioni di sistema. Poiché la parola chiave DRIVER non usa informazioni dalle informazioni di sistema, il driver deve definire parole chiave sufficienti in modo che un driver possa connettersi a un'origine dati usando solo le informazioni nelle stringhe di connessione della richiesta di esplorazione.
In ogni chiamata a SQLBrowseConnect, l'applicazione specifica i valori dell'attributo di connessione nella stringa di connessione della richiesta di esplorazione. Il driver restituisce livelli successivi di attributi e valori di attributo nella stringa di connessione del risultato di esplorazione; restituisce SQL_NEED_DATA finché sono presenti attributi di connessione che non sono ancora stati enumerati nella stringa di connessione della richiesta di esplorazione. L'applicazione usa il contenuto della stringa di connessione del risultato sfoglia per compilare la stringa di connessione della richiesta di esplorazione per la chiamata successiva a SQLBrowseConnect. Tutti gli attributi obbligatori (quelli non preceduti da un asterisco nell'argomento OutConnectionString ) devono essere inclusi nella chiamata successiva a SQLBrowseConnect. Si noti che l'applicazione non può usare il contenuto delle stringhe di connessione dei risultati di esplorazione precedenti durante la compilazione della stringa di connessione della richiesta di esplorazione corrente; ovvero non può specificare valori diversi per gli attributi impostati nei livelli precedenti.
Quando tutti i livelli di connessione e i relativi attributi associati sono stati enumerati, il driver restituisce SQL_SUCCESS, la connessione all'origine dati è completa e viene restituita una stringa di connessione completa all'applicazione. La stringa di connessione è adatta all'uso, insieme a SQLDriverConnect, con l'opzione SQL_DRIVER_NOPROMPT per stabilire un'altra connessione. La stringa di connessione completa non può essere usata in un'altra chiamata a SQLBrowseConnect, ma se sqlBrowseConnect è stato chiamato di nuovo, l'intera sequenza di chiamate dovrà essere ripetuta.
SQLBrowseConnect restituisce anche SQL_NEED_DATA se sono presenti errori ripristinabili e non irreversibili durante il processo di esplorazione, ad esempio una password o una parola chiave di attributo non valida fornita dall'applicazione. Quando viene restituito SQL_NEED_DATA e la stringa di connessione del risultato di esplorazione è invariata, si è verificato un errore e l'applicazione può chiamare SQLGetDiagRec per restituire SQLSTATE per gli errori di ricerca. In questo modo l'applicazione può correggere l'attributo e continuare l'esplorazione.
Un'applicazione può terminare il processo di esplorazione in qualsiasi momento chiamando SQLDisconnect. Il driver terminerà tutte le connessioni in sospeso e restituirà la connessione a uno stato non connesso.
Se le operazioni asincrone sono abilitate nell'handle di connessione, SQLBrowseConnect potrebbe restituire anche SQL_STILL_EXECUTING. Quando restituisce SQL_NEED_DATA, un'applicazione deve usare SQLDisconnect per annullare il processo di esplorazione. Se SQLBrowseConnect restituisce SQL_STILL_EXECUTING, un'applicazione deve usare SQLCancelHandle per annullare l'operazione in corso. La chiamata a SQLCancelHandle dopo che la funzione restituisce SQL_NEED_DATA non ha alcun effetto.
Per altre informazioni, vedere Connessione con SQLBrowseConnect.
Se un driver supporta SQLBrowseConnect, la sezione della parola chiave driver nelle informazioni di sistema per il driver deve contenere la parola chiave ConnectFunctions con il terzo set di caratteri su "Y".
Esempio di codice
Nota
Se ci si connette a un provider di origini dati che supporta l'autenticazione di Windows, è consigliabile specificare Trusted_Connection=yes anziché l'ID utente e le informazioni sulla password nella stringa di connessione.
Nell'esempio seguente un'applicazione chiama ripetutamente SQLBrowseConnect . Ogni volta che SQLBrowseConnect restituisce SQL_NEED_DATA, restituisce informazioni sui dati necessari in *OutConnectionString. L'applicazione passa OutConnectionString alla routine GetUserInput (non visualizzata). GetUserInput analizza le informazioni, compila e visualizza una finestra di dialogo e restituisce le informazioni immesse dall'utente in *InConnectionString. L'applicazione passa le informazioni dell'utente al driver nella chiamata successiva a SQLBrowseConnect. Dopo che l'applicazione ha fornito tutte le informazioni necessarie per la connessione del driver all'origine dati, SQLBrowseConnect restituisce SQL_SUCCESS e l'applicazione procede.
Per un esempio più dettagliato di connessione a un driver di SQL Server chiamando SQLBrowseConnect, vedere Esempio di esplorazione di SQL Server.
Ad esempio, per connettersi all'origine dati Sales, potrebbero verificarsi le azioni seguenti. Prima di tutto, l'applicazione passa la stringa seguente a SQLBrowseConnect:
"DSN=Sales"
Gestione driver carica il driver associato all'origine dati Sales. Chiama quindi la funzione SQLBrowseConnect del driver con gli stessi argomenti ricevuti dall'applicazione. Il driver restituisce la stringa seguente in *OutConnectionString:
"HOST:Server={red,blue,green};UID:ID=?;PWD:Password=?"
L'applicazione passa questa stringa alla routine GetUserInput , che crea una finestra di dialogo che chiede all'utente di selezionare il server rosso, blu o verde e di immettere un ID utente e una password. La routine passa di nuovo le informazioni specificate dall'utente seguenti in *InConnectionString, che l'applicazione passa a SQLBrowseConnect:
"HOST=red;UID=Smith;PWD=Sesame"
SQLBrowseConnect usa queste informazioni per connettersi al server rosso come Smith con la password Sesame e quindi restituisce la stringa seguente in *OutConnectionString:
"*DATABASE:Database={SalesEmployees,SalesGoals,SalesOrders}"
L'applicazione passa questa stringa alla routine GetUserInput , che compila una finestra di dialogo che chiede all'utente di selezionare un database. L'utente seleziona empdata e l'applicazione chiama SQLBrowseConnetti un'ora finale con questa stringa:
"DATABASE=SalesOrders"
Questa è la parte finale di informazioni che il driver deve connettersi all'origine dati; SQLBrowseConnect restituisce SQL_SUCCESS e *OutConnectionString contiene la stringa di connessione completata:
// SQLBrowseConnect_Function.cpp
// compile with: odbc32.lib
#include <windows.h>
#include <sqltypes.h>
#include <sqlext.h>
#define BRWS_LEN 100
SQLHENV henv;
SQLHDBC hdbc;
SQLHSTMT hstmt;
SQLRETURN retcode;
SQLCHAR szConnStrIn[BRWS_LEN], szConnStrOut[BRWS_LEN];
SQLSMALLINT cbConnStrOut;
void GetUserInput(SQLCHAR * szConnStrOut, SQLCHAR * szConnStrIn) {}
int main() {
// Allocate the environment handle.
retcode = SQLAllocHandle(SQL_HANDLE_ENV, SQL_NULL_HANDLE, &henv);
if (retcode == SQL_SUCCESS || retcode == SQL_SUCCESS_WITH_INFO) {
// Set the version environment attribute.
retcode = SQLSetEnvAttr(henv, SQL_ATTR_ODBC_VERSION, (SQLPOINTER*)SQL_OV_ODBC3, 0);
if (retcode == SQL_SUCCESS || retcode == SQL_SUCCESS_WITH_INFO) {
// Allocate the connection handle.
retcode = SQLAllocHandle(SQL_HANDLE_DBC, henv, &hdbc);
if (retcode == SQL_SUCCESS || retcode == SQL_SUCCESS_WITH_INFO) {
// Call SQLBrowseConnect until it returns a value other than SQL_NEED_DATA
// (pass data source name the first time). If SQL_NEED_DATA is returned, call GetUserInput
// (not shown) to build a dialog from the values in szConnStrOut. The user-supplied values
// are returned in szConnStrIn, which is passed in the next call to SQLBrowseConnect.
strcpy_s((char*)szConnStrIn, _countof(szConnStrIn), "DSN=Sales");
do {
retcode = SQLBrowseConnect(hdbc, szConnStrIn, SQL_NTS,
szConnStrOut, BRWS_LEN, &cbConnStrOut);
if (retcode == SQL_NEED_DATA)
GetUserInput(szConnStrOut, szConnStrIn);
} while (retcode == SQL_NEED_DATA);
if (retcode == SQL_SUCCESS || retcode == SQL_SUCCESS_WITH_INFO){
// Allocate the statement handle.
retcode = SQLAllocHandle(SQL_HANDLE_STMT, hdbc, &hstmt);
if (retcode == SQL_SUCCESS || retcode == SQL_SUCCESS_WITH_INFO)
// Process data after successful connection
SQLFreeHandle(SQL_HANDLE_STMT, hstmt);
SQLDisconnect(hdbc);
}
}
SQLFreeHandle(SQL_HANDLE_DBC, hdbc);
}
}
SQLFreeHandle(SQL_HANDLE_ENV, henv);
}
Funzioni correlate
| Per informazioni su | Vedere |
|---|---|
| Allocazione di un handle di connessione | Funzione SQLAllocHandle |
| Connessione a un'origine dati | Funzione SQLConnect |
| Disconnessione da un'origine dati | Funzione SQLDisconnect |
| Connessione a un'origine dati tramite una stringa di connessione o una finestra di dialogo | Funzione SQLDriverConnect |
| Restituzione di descrizioni e attributi del driver | Funzione SQLDrivers |
| Liberare un handle di connessione | Funzione SQLFreeHandle |
Vedi anche
Commenti e suggerimenti
Presto disponibile: nel corso del 2024 verranno dismessi i problemi di GitHub come meccanismo di feedback per il contenuto e verranno sostituiti con un nuovo sistema di feedback. Per altre informazioni, vedere: https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per