Aracılığıyla paylaş


Yükleyici DLL API'si başvurusu

Şunlar için geçerlidir:SQL ServerAzure SQL VeritabanıAzure SQL Yönetilen Örneği

Yükleyici DLL API'si ODBC veri kaynaklarının, sürücülerin ve çeviricilerin programlı yönetimine yönelik işlevler sağlar. Uygulamalar ve kurulum programları ODBC bileşenlerini yüklemek, yapılandırmak ve kaldırmak ve kayıt defteri bilgilerini yönetmek için bu işlevleri kullanır. Microsoft, Yükleyici DLL'sini yazar ve yeniden dağıtır.

API 25 işlevden oluşur. Bu işlevlerden üçü, SQLGetTranslator, SQLRemoveDSNFromInive SQLWriteDSNToIni, yalnızca kurulum DLL'leri tarafından çağrılır. Kurulum ve yönetim programları diğer işlevleri çağırır.

Her işlev, tanıtıldığı ODBC sürümüyle etiketlenmiştir.

Veri kaynağı yapılandırması

Bu işlevler ODBC veri kaynaklarını program aracılığıyla oluşturur, değiştirir ve kaldırır. Kullanıcı etkileşimi olmadan veri kaynağı bağlantılarını yapılandırması gereken özel kurulum programları veya uygulamaları oluştururken bunları kullanın.

İşlev Description
SQLConfigDataSource Veri kaynağını ekler, değiştirir veya siler. Gerçek yapılandırmayı gerçekleştirmek için sürücü kurulum DLL'sini çağırır.
SQLCreateDataSource Kullanıcıların etkileşimli olarak veri kaynağı eklemesine olanak tanıyan bir iletişim kutusu görüntüler.
SQLManageDataSources ODBC Veri Kaynağı Yöneticisine benzer şekilde veri kaynaklarını ve izleme seçeneklerini yönetmek için bir iletişim kutusu görüntüler.
SQLValidDSN Kayıt defterine yazılmadan önce veri kaynağı adının uzunluğunu ve geçerliliğini denetler.
SQLReadFileDSN Dosya tabanlı veri kaynağı adından (.dsn dosyası) bağlantı bilgilerini okur.
SQLWriteFileDSN Bağlantı bilgilerini dosya tabanlı veri kaynağı adına (.dsn dosyası) yazar.
SQLRemoveDefaultDataSource Sistem bilgilerinden varsayılan veri kaynağını kaldırır.

Sürücü yükleme ve kaldırma

Bu işlevler ODBC sürücülerini sistemden yükler ve kaldırır. Aynı sürücüleri paylaşan birden çok uygulamayı desteklemek için kayıt defteri girdilerini ve kullanım sayılarını yönetir.

İşlev Description
SQLInstallDriverEx Kayıt defterine sürücü bilgilerini ekler ve sürücünün kullanım sayısını artırır. Sürücü dosyaları için hedef dizini döndürür.
SQLInstallDriverManager ODBC çekirdek bileşenlerini yüklemek için hedef dizini döndürür. Sürücü Yöneticisi Windows'un bir parçası olduğundan ODBC 3.0'da kullanım dışı bırakıldı.
SQLRemoveDriver Kayıt defterinden sürücü bilgilerini kaldırır. Sürücünün kullanım sayısını siler ve sayı sıfıra ulaştığında kayıt defteri girdilerini kaldırır.
SQLRemoveDriverManager ODBC çekirdek bileşeni kullanım sayısını düşürür. Sürücü Yöneticisi artık Windows'un bir parçası olduğundan kullanım dışı bırakıldı.
SQLConfigDriver Bir sürücünün kurulum DLL'sini ConfigDriver yükler ve sürücüye özgü yapılandırma görevlerini gerçekleştirmek için işlevini çağırır.

Çevirmen yükleme ve kaldırma

Bu işlevler, verileri karakter kümeleri arasında (örneğin ANSI'den Unicode'a) dönüştüren ODBC çeviricilerini yönetir. Uygulamanız bir veri kaynağıyla iletişim sırasında veri çevirisi gerektirdiğinde bunları kullanın.

İşlev Description
SQLInstallTranslatorEx Kayıt defterine translator bilgilerini ekler ve çevirmenin kullanım sayısını artırır.
SQLInstallTranslator Bir çevirmen yükler. Kaldırıl -mış; yerine kullanın SQLInstallTranslatorEx .
SQLRemoveTranslator Kayıt defterinden çeviri bilgilerini kaldırır. Kullanım sayısını azaltma ve sayı sıfıra ulaştığında girişleri kaldırma.
SQLGetTranslator Çevirici seçmek için bir iletişim kutusu görüntüler. Kullanıcılardan çeviri çevirisi seçimi istemesi için sürücü kurulum DLL'leri tarafından çağrılır.

Kayıt defteri ve yapılandırma yardımcı programları

Bu işlevler, Windows kayıt defterinin ODBC bölümünde yapılandırma verilerini okur ve yazar. Diğer yükleyici işlevleri ve sürücü kurulum DLL'leri bunları dahili olarak kullanır.

İşlev Description
SQLWriteDSNToIni Kayıt defterine bir veri kaynağı adı ekler. Yeni bir veri kaynağı oluştururken sürücü kurulum DLL'leri tarafından çağrılır.
SQLRemoveDSNFromIni Kayıt defterinden bir veri kaynağı adı kaldırır. Veri kaynağını silerken sürücü kurulum DLL'leri tarafından çağrılır.
SQLGetPrivateProfileString Kayıt defterindeki bir veri kaynağı belirtimi alt anahtarından bir değer okur.
SQLWritePrivateProfileString Kayıt defterindeki bir veri kaynağı belirtimi alt anahtarına bir değer yazar.
SQLGetInstalledDrivers Kayıt defterinden yüklü ODBC sürücülerinin listesini döndürür.
SQLGetConfigMode Veri kaynağı girişleri için hangi kayıt defteri konumunun (kullanıcı veya sistem) kullanıldığını gösteren yapılandırma modunu alır.
SQLSetConfigMode Veri kaynağı girdilerinin kayıt defterinde nereye yazıldığını gösteren yapılandırma modunu ayarlar.

Hata yönetimi

Bu işlevler, yükleyici işlevleri başarısız olduğunda hata bilgileri sağlar.

İşlev Description
SQLInstallerError Yükleyici işlevleri için hata veya durum bilgilerini döndürür. Yükleyici DLL'sindeki her işlev, bu işlev tarafından alınabilecek sıfır veya daha fazla hata döndürür.
SQLPostInstallerError Sürücü kurulumu DLL'lerinin hataları döndürebilmesi için yükleyici hata kuyruğuna bildirmesine SQLInstallerError izin verir.