Dela via

SQLManageDataSources

  • Artikel

Efterlevnad
Version introducerad: ODBC 2.0

Sammanfattning
SQLManageDataSources visar en dialogruta med vilken användare kan konfigurera, lägga till och ta bort datakällor i systeminformationen.

Syntax

  
BOOL SQLManageDataSources(  
     HWND     hwnd);

Argument

hwnd
[Indata] Överordnat fönsterhandtag.

Returnerar

SQLManageDataSources returnerar FALSE om hwnd inte är ett giltigt fönsterhandtag. Annars returneras TRUE.

Diagnostik

När SQLManageDataSources returnerar FALSE kan ett associerat *pfErrorCode- värde hämtas genom att anropa SQLInstallerError. I följande tabell visas *pfErrorCode värden som kan returneras av SQLInstallerError och förklarar var och en i kontexten för den här funktionen.

*pfErrorCode Fel Beskrivning
ODBC_ERROR_GENERAL_ERR Allmänt installationsfel Ett fel uppstod för vilket det inte fanns något specifikt installationsfel.
ODBC_ERROR_REQUEST_FAILED begärande misslyckades Anropet till ConfigDSN misslyckades.
ODBC_ERROR_INVALID__HWND Ogiltigt fönsterhandtag Argumentet hwnd var ogiltigt eller NULL.
ODBC_ERROR_OUT_OF_MEM Slut på minne Installationsprogrammet kunde inte utföra funktionen på grund av brist på minne.

Hantera datakällor

SQLManageDataSources visar inledningsvis dialogrutan ODBC-datakälladministratör, som du ser i följande bild.

dialogrutan ODBC-datakälladministratör

Dialogrutan visar de datakällor som anges i systeminformationen under tre flikar: User DSN, System DSNoch File DSN. Om användaren dubbelklickar på en datakälla eller väljer en datakälla och klickar på Konfigureraanropar SQLManageDataSourcesConfigDSN i konfigurations-DLL med alternativet ODBC_CONFIG_DSN.

Om användaren klickar på Lägg tillvisar SQLManageDataSources dialogrutan Skapa ny datakälla i följande bild.

dialogrutan Skapa ny datakälla

Dialogrutan visar en lista över installerade drivrutiner. Om användaren dubbelklickar på en drivrutin eller väljer en drivrutin och klickar på OKanropar SQLManageDataSourcesConfigDSN i konfigurations-DLL:en och skickar det ODBC_ADD_DSN alternativet.

Om användaren väljer en datakälla och klickar på Ta bortSQLManageDataSources frågar om användaren vill ta bort datakällan. Om användaren klickar på Jaanropar SQLManageDataSourcesConfigDSN i konfigurations-DLL med alternativet ODBC_REMOVE_DSN.

Dialogrutan Skapa ny datakälla används för att lägga till eller ta bort en användardatakälla, en systemdatakälla eller en fildatakälla.

Användar-DSN:er

DSN:er som skapats för enskilda användare kallas användar-DSN:er för att skilja dem från system-DSN:er. Användar-DSN:er registreras enligt följande i systeminformationen:

HKEY_CURRENT_USERS

SOFTWARE

ODBC

Odbc.ini

System-DSN

I dialogrutan Skapa ny datakälla kan du lägga till en systemdatakälla på den lokala datorn eller ta bort en eller ange konfigurationen för en systemdatakälla.

En datakälla som har konfigurerats med ett systemdatakällnamn (DSN) kan användas av mer än en användare på samma dator. Den kan också användas av en systemomfattande tjänst, som sedan kan få åtkomst till datakällan även om ingen användare är inloggad på datorn.

Ett system-DSN registreras i posten HKEY_LOCAL_MACHINE i systeminformationen i stället för i posten HKEY_CURRENT_USER. Det är inte kopplat till en användare som loggar in med sitt specifika användarnamn och lösenord, men kan användas av alla användare på den datorn eller av en automatisk systemomfattande tjänst. System-DSN är dock kopplat till en dator. Det stöder inte möjligheten att använda fjärr-DSN:er mellan datorer. System-DSN:er registreras enligt följande i systeminformationen:

HKEY_LOCAL_MACHINE SOFTWARE ODBC Odbc.ini

Fil-DSN

En fildatakälla har inget namn på datakällan, liksom en datordatakälla, och är inte registrerad på någon användare eller dator. Anslutningsinformationen för datakällan finns i en .dsn-fil som kan kopieras till valfri dator. En fildatakälla kan delas, i vilket fall .dsn-filen finns i ett nätverk och kan användas samtidigt av flera användare i nätverket så länge användaren har rätt drivrutin installerad. En fildatakälla kan också vara odelningsbar, i så fall kan den endast användas på en enda dator.

Mer information om fildatakällor finns i Ansluta med fildatakällor, eller se SQLDriverConnect.

Hantera drivrutiner

Om användaren klickar på fliken Drivrutiner i dialogrutan ODBC-datakälladministratör visar SQLManageDataSources en lista över ODBC-drivrutiner som är installerade i systemet samt information om drivrutinerna. Det datum som visas är drivrutinens skapandedatum, enligt följande bild.

fliken Administratörsdrivrutiner för ODBC-datakälla

Spårningsalternativ

Om användaren klickar på fliken Spårning i dialogrutan ODBC-datakälladministratörSQLManageDataSources visar spårningsalternativ, enligt följande bild.

fliken Administratörsspårning för ODBC-datakälla

Om användaren klickar på Starta spårning nu och sedan klickar på OKSQLManageDataSources aktiverar spårning manuellt för alla program som körs på datorn.

Om användaren anger namnet på en spårningsfil i textrutan Loggfilsökväg och sedan klickar på OKanger SQLManageDataSourcesTraceFile nyckelordet i avsnittet [ODBC] i systeminformationen till det angivna namnet.

Viktig

Stöd för Visual Studio Analyzer togs bort från och med Windows 8 (Visual Studio Analyzer ingick endast i äldre versioner av Visual Studio.). Om du vill ha en alternativ felsökningsmekanism använder du BID-spårning.

Om användaren klickar på Starta Visual Studio Analyzer och sedan klickar på OKaktiveras Visual Studio Analyzer. Den förblir aktiverad tills Stoppa Visual Studio Analyzer klickas.

Mer information om spårning finns i Spårning. Mer information om nyckelorden Trace och TraceFile finns i ODBC-undernyckel.

Mer information om Se
Skapa datakällor SQLCreateDataSource