Allocazione dell'handle di ambiente

La prima attività per qualsiasi applicazione ODBC consiste nel caricare il Gestore di driver, operazione dipendente dal sistema operativo. Ad esempio, in un computer che esegue Microsoft Windows NT Server/Windows 2000 Server, Windows NT Workstation/Windows 2000 Professional o Microsoft Windows 95/98, l'applicazione si collega alla libreria di Gestione driver o chiama LoadLibrary per caricare la DLL di Gestione driver.

L'attività successiva, che deve essere eseguita prima che un'applicazione possa chiamare qualsiasi altra funzione ODBC, consiste nell'inizializzare l'ambiente ODBC e allocare un handle di ambiente, come indicato di seguito:

1. L'applicazione dichiara una variabile di tipo SQLHENV. Chiama quindi SQLAllocHandle e passa l'indirizzo di questa variabile e l'opzione SQL_HANDLE_ENV. Per esempio:

   SQLHENV henv1;  
   
   SQLAllocHandle(SQL_HANDLE_ENV, SQL_NULL_HANDLE, &henv1);  
   

2. Il Gestore driver alloca una struttura per memorizzare le informazioni sull'ambiente e restituisce l'handle di ambiente nella variabile.

Il Gestore Driver non chiama SQLAllocHandle in questo momento nel driver perché non sa quale driver chiamare. Ritarda la chiamata a SQLAllocHandle nel driver finché l'applicazione non chiama una funzione per connettersi a un'origine dati. Per ulteriori informazioni, vedere Il ruolo del Driver Manager nel processo di connessione, nel seguito di questa sezione.

Al termine dell'uso di ODBC, l'applicazione libera l'handle dell'ambiente con SQLFreeHandle. Dopo aver liberato l'ambiente, usare l'handle dell'ambiente in una chiamata a una funzione ODBC è un errore di programmazione dell'applicazione; ciò comporta conseguenze non definite ma probabilmente fatali.

Quando viene chiamato SQLFreeHandle , il driver rilascia la struttura usata per archiviare informazioni sull'ambiente. Si noti che SQLFreeHandle non può essere chiamato per un handle di ambiente fino a quando non sono stati liberati tutti gli handle di connessione in tale handle di ambiente.

Per ulteriori informazioni sui gestori dell'ambiente, vedere Gestori dell'ambiente.