Share via

Naslaginformatie over DLL-API voor installatieprogramma

Van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

De DLL-API van installer biedt functies voor programmatisch beheer van ODBC-gegevensbronnen, stuurprogramma's en vertalers. Toepassingen en installatieprogramma's gebruiken deze functies voor het installeren, configureren en verwijderen van ODBC-onderdelen en voor het beheren van registergegevens. Microsoft schrijft en herdistribueert het DLL-bestand van het installatieprogramma.

De API bestaat uit 25 functies. Drie van deze functies, SQLGetTranslator, SQLRemoveDSNFromInien SQLWriteDSNToIni, worden alleen aangeroepen door DLL's in te stellen. Installatie- en beheerprogramma's roepen de andere functies aan.

Elke functie wordt gelabeld met de versie van ODBC waarin deze is geïntroduceerd.

Configuratie van gegevensbron

Met deze functies worden ODBC-gegevensbronnen programmatisch gemaakt, gewijzigd en verwijderd. Gebruik deze bij het bouwen van aangepaste installatieprogramma's of toepassingen die gegevensbronverbindingen moeten configureren zonder tussenkomst van de gebruiker.

Functie Description
SQLConfigDataSource Hiermee voegt u een gegevensbron toe, wijzigt of verwijdert u deze. Roept het DLL-bestand voor het instellen van het stuurprogramma aan om de werkelijke configuratie uit te voeren.
SQLCreateDataSource Hiermee wordt een dialoogvenster weergegeven waarmee gebruikers interactief een gegevensbron kunnen toevoegen.
SQLManageDataSources Hiermee wordt een dialoogvenster weergegeven voor het beheren van gegevensbronnen en traceringsopties, vergelijkbaar met de ODBC-gegevensbronbeheerder.
SQLValidDSN Controleert de lengte en geldigheid van een gegevensbronnaam voordat deze naar het register wordt geschreven.
SQLReadFileDSN Leest verbindingsgegevens uit een op bestanden gebaseerde gegevensbronnaam (.dsn-bestand).
SQLWriteFileDSN Hiermee schrijft u verbindingsgegevens naar een op bestanden gebaseerde gegevensbronnaam (.dsn-bestand).
SQLRemoveDefaultDataSource Hiermee verwijdert u de standaardgegevensbron uit de systeemgegevens.

Installatie en verwijdering van stuurprogramma's

Met deze functies worden ODBC-stuurprogramma's van het systeem geïnstalleerd en verwijderd. Ze beheren registervermeldingen en het aantal gebruiksgegevens ter ondersteuning van meerdere toepassingen die dezelfde stuurprogramma's delen.

Functie Description
SQLInstallDriverEx Hiermee voegt u stuurprogrammagegevens toe aan het register en wordt het aantal gebruiksgegevens van het stuurprogramma verhoogd. Retourneert de doelmap voor stuurprogrammabestanden.
SQLInstallDriverManager Retourneert de doelmap voor het installeren van ODBC-kernonderdelen. Afgeschaft in ODBC 3.0 omdat driverbeheer deel uitmaakt van Windows.
SQLRemoveDriver Hiermee verwijdert u stuurprogrammagegevens uit het register. Hiermee wordt het aantal gebruiksgegevens van het stuurprogramma ongedaan gemaakt en worden registervermeldingen verwijderd wanneer het aantal nul bereikt.
SQLRemoveDriverManager Hiermee wordt het aantal ODBC-kernonderdelengebruik afgerekend. Afgeschaft omdat driverbeheer nu deel uitmaakt van Windows.
SQLConfigDriver Laadt het INSTALLATIE-DLL-bestand van een stuurprogramma en roept de ConfigDriver bijbehorende functie aan om stuurprogrammaspecifieke configuratietaken uit te voeren.

Translator-installatie en -verwijdering

Met deze functies worden ODBC-vertalers beheerd, waarmee gegevens tussen tekensets (bijvoorbeeld ANSI naar Unicode) worden geconverteerd. Gebruik deze wanneer uw toepassing gegevensomzetting vereist tijdens de communicatie met een gegevensbron.

Functie Description
SQLInstallTranslatorEx Hiermee voegt u vertaalgegevens toe aan het register en wordt het aantal gebruiksgegevens van de vertaler verhoogd.
SQLInstallTranslator Hiermee wordt een vertaler geïnstalleerd. Afgekeurd; gebruik SQLInstallTranslatorEx in plaats daarvan.
SQLRemoveTranslator Hiermee verwijdert u vertaalgegevens uit het register. Hiermee wordt het aantal gebruiksrechten ongedaan gemaakt en worden vermeldingen verwijderd wanneer het aantal nul bereikt.
SQLGetTranslator Hiermee wordt een dialoogvenster weergegeven voor het selecteren van een vertaler. Aangeroepen door stuurprogramma-DLL's voor het instellen van stuurprogramma's om gebruikers te vragen om de selectie van vertalers.

Hulpprogramma's voor register en configuratie

Deze functies lezen en schrijven configuratiegegevens in de ODBC-sectie van het Windows-register. Andere installatiefuncties en installatie-DLL's van stuurprogramma's gebruiken ze intern.

Functie Description
SQLWriteDSNToIni Hiermee voegt u een gegevensbronnaam toe aan het register. Aangeroepen door dll's voor het instellen van stuurprogramma's bij het maken van een nieuwe gegevensbron.
SQLRemoveDSNFromIni Hiermee verwijdert u de naam van een gegevensbron uit het register. Aangeroepen door stuurprogramma-DLL's voor installatie bij het verwijderen van een gegevensbron.
SQLGetPrivateProfileString Leest een waarde uit een subsleutel voor gegevensbronspecificatie in het register.
SQLWritePrivateProfileString Hiermee schrijft u een waarde naar een subsleutel van de gegevensbronspecificatie in het register.
SQLGetInstalledDrivers Retourneert een lijst met geïnstalleerde ODBC-stuurprogramma's uit het register.
SQLGetConfigMode Haalt de configuratiemodus op die aangeeft welke registerlocatie (gebruiker of systeem) wordt gebruikt voor gegevensbronvermeldingen.
SQLSetConfigMode Hiermee stelt u de configuratiemodus in die aangeeft waar gegevensbronvermeldingen in het register worden geschreven.

Foutafhandeling

Deze functies bieden foutinformatie wanneer de installatiefuncties mislukken.

Functie Description
SQLInstallerError Retourneert fout- of statusinformatie voor installatiefuncties. Elke functie in het DLL-bestand van het installatieprogramma plaatst nul of meer fouten die door deze functie kunnen worden opgehaald.
SQLPostInstallerError Hiermee kunnen DLL's voor het instellen van stuurprogramma's fouten rapporteren aan de wachtrij voor installatiefouten, zodat SQLInstallerError deze kunnen worden geretourneerd.

Verwante inhoud

  • Last updated on