Ortam Tanıtıcısını Tahsis Etme

Herhangi bir ODBC uygulamasının ilk görevi Sürücü Yöneticisi'ni yüklemektir; bunun nasıl yapıldığı işletim sistemine bağlıdır. Örneğin, Microsoft Windows NT Server/Windows 2000 Server, Windows NT Workstation/Windows 2000 Professional veya Microsoft Windows 95/98 çalıştıran bir bilgisayarda, uygulama Driver Manager kitaplığına bağlanır veya Driver Manager DLL'sini yüklemek için LoadLibrary'yi çağırır.

Bir uygulamanın başka bir ODBC işlevini çağırabilmesi için yapılması gereken bir sonraki görev, ODBC ortamını başlatmak ve aşağıdaki gibi bir ortam tanıtıcısı ayırmaktır:

1. Uygulama SQLHENV türünde bir değişken bildirir. Ardından SQLAllocHandle'ı çağırır ve bu değişkenin adresini ve SQL_HANDLE_ENV seçeneğini geçirir. Örneğin:

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

2. Driver Manager, ortamla ilgili bilgilerin depolandığı bir yapı ayırır ve değişkende ortam tutamacını döndürür.

Sürücü Yöneticisi şu anda sürücüde SQLAllocHandle'ı çağırmaz çünkü hangi sürücünün çağrıldığını bilmez. Uygulama bir veri kaynağına bağlanmak için bir işlev çağırana kadar sürücüde SQLAllocHandle çağrısını geciktirer. Daha fazla bilgi için, bu bölümün devamında yer alan Bağlantı İşlemi'nde Sürücü Yöneticisi rolü bölümüne bakın.

Uygulama ODBC'yi kullanmayı bitirdiğinde, ORTAM tutamacını SQLFreeHandle ile serbestleştirir. Ortam boşaltıldıktan sonra, bir ODBC işlevi çağrısında ortamın tutamacını kullanmak bir uygulama programlama hatasıdır; Bunun tanımlanmamış ama büyük olasılıkla ölümcül sonuçları vardır.

SQLFreeHandle çağrıldığında, sürücü ortam hakkındaki bilgileri depolamak için kullanılan yapıyı serbest bırakır. Ortam tanıtıcısı üzerindeki tüm bağlantı tanıtıcıları serbest bırakılmadıkça SQLFreeHandle'ın ortam tanıtıcısı için çağrılamayacağını unutmayın.

Ortam tanıtıcısı hakkında daha fazla bilgi için bkz. Ortam Tanıtıcıları.