SQLManageDataSources

conformance
Versie geïntroduceerd: ODBC 2.0

Samenvattings-
SQLManageDataSources geeft een dialoogvenster weer waarmee gebruikers gegevensbronnen in de systeemgegevens kunnen instellen, toevoegen en verwijderen.

Syntaxis

  
BOOL SQLManageDataSources(  
     HWND     hwnd);  

Argumenten

[Invoer] Bovenliggende venstergreep.

Retourneert

SQLManageDataSources retourneert FALSE als hwnd geen geldige venstergreep is. Anders wordt TRUE geretourneerd.

Diagnostiek

Wanneer SQLManageDataSources ONWAAR retourneert, kan een gekoppelde *pfErrorCode-waarde worden verkregen door SQLInstallerError-aan te roepen. De volgende tabel bevat de *pfErrorCode waarden die kunnen worden geretourneerd door SQLInstallerError- en worden deze in de context van deze functie uitgelegd.

*pfErrorCode	Fout	Beschrijving
ODBC_ERROR_GENERAL_ERR	Algemene installatiefout	Er is een fout opgetreden waarvoor er geen specifieke installatiefout is opgetreden.
ODBC_ERROR_REQUEST_FAILED	aanvraag mislukt	De aanroep van ConfigDSN- is mislukt.
ODBC_ERROR_INVALID__HWND	Ongeldige venstergreep	Het argument hwnd is ongeldig of NULL.
ODBC_ERROR_OUT_OF_MEM	Onvoldoende geheugen	Het installatieprogramma kan de functie niet uitvoeren vanwege een gebrek aan geheugen.

Gegevensbronnen beheren

SQLManageDataSources in eerste instantie het dialoogvenster ODBC-gegevensbronbeheerder, zoals wordt weergegeven in de volgende afbeelding.

In het dialoogvenster worden de gegevensbronnen weergegeven die worden vermeld in de systeeminformatie onder drie tabbladen: DSN-gebruikers-, Systeem-DSN-en Bestands-DSN-. Als de gebruiker dubbelklikt op een gegevensbron of een gegevensbron selecteert en op Configureerklikt, roept SQLManageDataSourcesConfigDSN- aan in het installatie-DLL-bestand met de optie ODBC_CONFIG_DSN.

Als de gebruiker op toevoegen klikt, wordt SQLManageDataSources het dialoogvenster Nieuwe gegevensbron maken weergegeven, zoals in de volgende afbeelding wordt weergegeven.

In het dialoogvenster wordt een lijst met geïnstalleerde stuurprogramma's weergegeven. Als de gebruiker dubbelklikt op een stuurprogramma of een stuurprogramma selecteert en op OKklikt, SQLManageDataSources roept ConfigDSN- aan in het installatie-DLL-bestand en geeft deze door aan de ODBC_ADD_DSN optie.

Als de gebruiker een gegevensbron selecteert en op Verwijderenklikt, wordt SQLManageDataSources gevraagd of de gebruiker de gegevensbron wil verwijderen. Als de gebruiker op Jaklikt, roept SQLManageDataSourcesConfigDSN- aan in het installatie-DLL-bestand met de optie ODBC_REMOVE_DSN.

Het dialoogvenster Nieuwe gegevensbron maken wordt gebruikt om een gebruikersgegevensbron, een systeemgegevensbron of een bestandsgegevensbron toe te voegen of te verwijderen.

DSN's van gebruikers

DSN's die zijn gemaakt voor afzonderlijke gebruikers, worden gebruikers-DSN's genoemd om deze te onderscheiden van systeem-DSN's. DSN's van gebruikers worden als volgt geregistreerd in de systeemgegevens:

HKEY_CURRENT_USERS

SOFTWARE

ODBC

Odbc.ini

Systeem-DSN's

In het dialoogvenster Nieuwe gegevensbron maken kunt u een systeemgegevensbron toevoegen aan uw lokale computer of een gegevensbron verwijderen of de configuratie voor een systeemgegevensbron instellen.

Een gegevensbron die is ingesteld met de naam van een systeemgegevensbron (DSN) kan door meer dan één gebruiker op dezelfde computer worden gebruikt. Het kan ook worden gebruikt door een systeemomvattende service, die vervolgens toegang kan krijgen tot de gegevensbron, zelfs als er geen gebruiker is aangemeld bij de computer.

Een systeem-DSN wordt geregistreerd in de HKEY_LOCAL_MACHINE vermelding in de systeeminformatie in plaats van in de HKEY_CURRENT_USER vermelding. Het is niet gekoppeld aan één gebruiker die zich aanmeldt met zijn of haar specifieke gebruikersnaam en wachtwoord, maar kan worden gebruikt door elke gebruiker van die computer of door een automatische systeemomvattende service. De systeem-DSN is echter gekoppeld aan één computer. Het biedt geen ondersteuning voor het gebruik van externe DSN's tussen computers. Systeem-DSN's worden als volgt geregistreerd in de systeeminformatie:

ODBC-Odbc.ini van SOFTWARE HKEY_LOCAL_MACHINE

Bestands-DSN's

Een bestandsgegevensbron heeft geen naam voor een gegevensbron, net als een computergegevensbron en is niet geregistreerd bij een gebruiker of computer. De verbindingsgegevens voor die gegevensbron bevinden zich in een DSN-bestand dat kan worden gekopieerd naar elke computer. Een bestandsgegevensbron kan worden gedeeld. In dat geval bevindt het .dsn-bestand zich in een netwerk en kan tegelijkertijd door meerdere gebruikers in het netwerk worden gebruikt zolang de gebruiker het juiste stuurprogramma heeft geïnstalleerd. Een bestandsgegevensbron kan ook niet worden gedeeld. In dat geval kan deze alleen op één computer worden gebruikt.

Zie Verbinding maken met bestandsgegevensbronnenof zie SQLDriverConnectvoor meer informatie over bestandsgegevensbronnen.

Stuurprogramma's beheren

Als de gebruiker op het tabblad Stuurprogramma's klikt in het dialoogvenster ODBC-gegevensbronbeheerder, geeft SQLManageDataSources een lijst weer met ODBC-stuurprogramma's die op het systeem zijn geïnstalleerd, evenals informatie over de stuurprogramma's. De weergegeven datum is de aanmaakdatum van het stuurprogramma, zoals wordt weergegeven in de volgende afbeelding.

Traceringsopties

Als de gebruiker op het tabblad Tracering klikt in het dialoogvenster ODBC-gegevensbronbeheerder, worden SQLManageDataSources traceringsopties weergegeven, zoals wordt weergegeven in de volgende afbeelding.

Als de gebruiker op Nu tracering starten klikt en vervolgens op OK-klikt, schakelt SQLManageDataSources tracering handmatig in voor alle toepassingen die momenteel op de computer worden uitgevoerd.

Als de gebruiker de naam van een traceringsbestand opgeeft in het tekstvak Logboekbestandspad en vervolgens op OKklikt, stelt SQLManageDataSources het trefwoord TraceFile in de sectie [ODBC] van de systeemgegevens in op de opgegeven naam.

Belangrijk

Ondersteuning voor Visual Studio Analyzer is verwijderd vanaf Windows 8 (Visual Studio Analyzer is alleen opgenomen in oudere versies van Visual Studio.). Gebruik BID-tracering voor een alternatief mechanisme voor probleemoplossing.

Als de gebruiker op Start Visual Studio Analyzer- klikt en vervolgens op OK-klikt, is Visual Studio Analyzer ingeschakeld. Het blijft ingeschakeld totdat Visual Studio Analyzer stoppen wordt geklikt.

Zie Traceringvoor meer informatie over tracering. Zie ODBC-subsleutelvoor meer informatie over de trefwoorden TraceFile en TraceFile.

Verwante functies

Voor informatie over	Zien
Gegevensbronnen maken	SQLCreateDataSource-