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.
SQLBrowseConnect, ad esempio SQLDriverConnect, usa una stringa di connessione. Tuttavia, usando SQLBrowseConnect, un'applicazione può costruire una stringa di connessione completa in fase di esecuzione. In questo modo l'applicazione può eseguire due operazioni:
Creare finestre di dialogo personalizzate per richiedere queste informazioni, mantenendo così il controllo sull'aspetto.
Esplorare il sistema per le origini dati che possono essere usate da un determinato driver, possibilmente in diversi passaggi. Ad esempio, l'utente potrebbe prima esplorare la rete per i server e, dopo aver scelto un server, cercare i database accessibili dal driver.
L'applicazione chiama SQLBrowseConnect e passa una stringa di connessione, nota come stringa di connessione della richiesta di esplorazione, che specifica un driver o un'origine dati. Il driver restituisce una stringa di connessione, nota come stringa di connessione del risultato di esplorazione, che contiene parole chiave, valori possibili (se la parola chiave accetta un set discreto di valori) e nomi descrittivi. L'applicazione crea una finestra di dialogo con i nomi facili da usare e sollecita l'utente a inserire i valori. Compila quindi una nuova stringa di connessione della richiesta di esplorazione da questi valori e la restituisce al driver con un'altra chiamata a SQLBrowseConnect.
Poiché le stringhe di connessione vengono passate avanti e indietro, il driver può fornire diversi livelli di esplorazione restituendo una nuova stringa di connessione quando l'applicazione restituisce quella precedente. Ad esempio, la prima volta che un'applicazione chiama SQLBrowseConnect, il driver potrebbe restituire parole chiave per richiedere all'utente un nome del server. Quando l'applicazione restituisce il nome del server, il driver potrebbe restituire parole chiave per richiedere all'utente un database. Il processo di esplorazione verrà completato dopo che l'applicazione ha restituito il nome del database.
Ogni volta che SQLBrowseConnect restituisce una nuova stringa di connessione del risultato di esplorazione, restituisce SQL_NEED_DATA come codice restituito. Indica all'applicazione che il processo di connessione non è stato completato. Finché SQLBrowseConnect non restituisce SQL_SUCCESS, la connessione è in stato Need Data e non può essere usata per altri scopi, ad esempio per impostare un attributo di connessione. L'applicazione può terminare il processo di esplorazione della connessione chiamando SQLDisconnect.
Questa sezione contiene l'argomento seguente.