Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
A következőkre vonatkozik:
SQL ServerAzure SQL DatabaseAzure SQL Managed Instance
A Installer DLL API függvényeket biztosít az ODBC-adatforrások, illesztőprogramok és fordítók programozott kezeléséhez. Az alkalmazások és a telepítőprogramok ezeket a függvényeket használják ODBC-összetevők telepítéséhez, konfigurálásához és eltávolításához, valamint a beállításjegyzék adatainak kezeléséhez. A Microsoft megírja és terjeszti a Installer DLL-t.
Az API 25 függvényből áll. Ezek közül három függvényt SQLGetTranslatorSQLRemoveDSNFromIniSQLWriteDSNToInicsak a telepítő DLL-ek hívnak meg. A beállítási és adminisztrációs programok meghívják a többi függvényt.
Minden függvény az ODBC azon verziójával van megjelölve, amelyben bevezették.
Adatforrás konfigurálása
Ezek a függvények programozott módon hoznak létre, módosítanak és távolítanak el ODBC-adatforrásokat. Ezeket olyan egyéni telepítőprogramok vagy alkalmazások létrehozásakor használhatja, amelyeknek felhasználói beavatkozás nélkül kell konfigurálnia az adatforrás-kapcsolatokat.
| Funkció | Description |
|---|---|
| SQLConfigDataSource | Adatforrás hozzáadása, módosítása vagy törlése. Meghívja az illesztőprogram telepítő DLL-jét a tényleges konfiguráció végrehajtásához. |
| SQLCreateDataSource | Megjelenít egy párbeszédpanelt, amelyen a felhasználók interaktív módon adhatnak hozzá adatforrást. |
| SQLManageDataSources | Az ODBC adatforrás-rendszergazdájához hasonló, adatforrások és nyomkövetési beállítások kezelésére szolgáló párbeszédpanelt jelenít meg. |
| SQLValidDSN | Ellenőrzi az adatforrás nevének hosszát és érvényességét, mielőtt az a beállításjegyzékbe íródott volna. |
| SQLReadFileDSN | Beolvassa a kapcsolati adatokat egy fájlalapú adatforrásnévből (.dsn fájlból). |
| SQLWriteFileDSN | Kapcsolati adatokat ír egy fájlalapú adatforrásnévbe (.dsn fájlba). |
| SQLRemoveDefaultDataSource | Eltávolítja az alapértelmezett adatforrást a rendszerinformációkból. |
Illesztőprogram telepítése és eltávolítása
Ezek a függvények telepítik és eltávolítják az ODBC-illesztőprogramokat a rendszerből. A beállításjegyzék bejegyzéseit és a használat számát kezelik, hogy több, azonos illesztőprogramot használó alkalmazás is támogatott legyen.
| Funkció | Description |
|---|---|
| SQLInstallDriverEx | Hozzáadja az illesztőprogram-adatokat a beállításjegyzékhez, és növeli az illesztőprogram használati számát. Az illesztőprogram-fájlok célkönyvtárát adja vissza. |
| SQLInstallDriverManager | Az ODBC-magösszetevők telepítéséhez használt célkönyvtárat adja vissza. Elavult az ODBC 3.0-ban, mert az illesztőprogram-kezelő a Windows része. |
| SQLRemoveDriver | Eltávolítja az illesztőprogram-adatokat a beállításjegyzékből. Az illesztőprogram kihasználtsága csökken, és eltávolítja a beállításjegyzék bejegyzéseit, amikor a darabszám eléri a nullát. |
| SQLRemoveDriverManager | Az ODBC-alapösszetevők használatának száma csökken. Elavult, mert az illesztőprogram-kezelő mostantól a Windows része. |
| SQLConfigDriver | Betölti az illesztőprogram telepítő DLL-jét, és meghívja annak függvényét ConfigDriver az illesztőprogram-specifikus konfigurációs feladatok végrehajtásához. |
Translator telepítése és eltávolítása
Ezek a függvények kezelik az ODBC-fordítókat, amelyek karakterkészletek (például ANSI) között konvertálják az adatokat Unicode-ra. Akkor használja őket, ha az alkalmazás adatfordítást igényel egy adatforrással való kommunikáció során.
| Funkció | Description |
|---|---|
| SQLInstallTranslatorEx | Hozzáadja a fordító adatait a beállításjegyzékhez, és növeli a fordító használati számát. |
| SQLInstallTranslator | Egy fordító telepítése. Elavult; helyett.SQLInstallTranslatorEx |
| SQLRemoveTranslator | Eltávolítja a fordító adatait a beállításjegyzékből. Ha a szám eléri a nullát, csökken a használat száma, és eltávolítja a bejegyzéseket. |
| SQLGetTranslator | Megjeleníti a fordító kiválasztására szolgáló párbeszédpanelt. Az illesztőprogram beállítási DLL-jeit hívva kérje meg a felhasználókat a fordító kiválasztására. |
Beállításjegyzék- és konfigurációs segédprogramok
Ezek a függvények beolvasják és megírják a konfigurációs adatokat a Windows-beállításjegyzék ODBC szakaszában. Más telepítőfüggvények és illesztőprogram-beállítási DLL-ek belsőleg használják őket.
| Funkció | Description |
|---|---|
| SQLWriteDSNToIni | Adatforrásnevet ad hozzá a beállításjegyzékhez. Új adatforrás létrehozásakor az illesztőprogram telepítő DLL-jeit hívja meg. |
| SQLRemoveDSNFromIni | Eltávolít egy adatforrásnevet a beállításjegyzékből. Adatforrás törlésekor az illesztőprogramok telepítő DLL-jeit hívja meg. |
| SQLGetPrivateProfileString | Beolvas egy értéket egy adatforrás-specifikáció alkulcsából a beállításjegyzékben. |
| SQLWritePrivateProfileString | Értéket ír egy adatforrás specifikációs alkulcsára a beállításjegyzékben. |
| SQLGetInstalledDrivers | A beállításjegyzékből származó telepített ODBC-illesztőprogramok listáját adja vissza. |
| SQLGetConfigMode | Lekéri azt a konfigurációs módot, amely jelzi, hogy melyik beállításjegyzék-helyet (felhasználót vagy rendszert) használja az adatforrás-bejegyzésekhez. |
| SQLSetConfigMode | Beállítja azt a konfigurációs módot, amely jelzi, hogy hol vannak megírva az adatforrás-bejegyzések a beállításjegyzékben. |
Hibakezelés
Ezek a függvények hibainformációkat nyújtanak, ha a telepítőfüggvények sikertelenek.
| Funkció | Description |
|---|---|
| SQLInstallerError | Hiba- vagy állapotinformációkat ad vissza a telepítőfüggvényekhez. A Installer DLL minden függvénye nulla vagy több, a függvény által lekérhető hibát jelez. |
| SQLPostInstallerError | Lehetővé teszi, hogy az illesztőprogram telepítő DLL-jei jelentsenek hibákat a telepítő hibasorába, hogy SQLInstallerError vissza tudják adni őket. |