SQLManageDataSources

megfelelőségi
Bevezetett verzió: ODBC 2.0

összefoglaló
SQLManageDataSources egy párbeszédpanelt jelenít meg, amellyel a felhasználók adatforrásokat állíthatnak be, adhatnak hozzá és törölhetnek a rendszerinformációkban.

Szintaxis

  
BOOL SQLManageDataSources(  
     HWND     hwnd);  

Érvek

hwnd
[Bemenet] Szülőablak fogópontja.

Visszatér

SQLManageDataSources hamis értéket ad vissza, ha hwnd érvénytelen ablakleíró. Ellenkező esetben IGAZ értéket ad vissza.

Diagnosztika

Ha SQLManageDataSources hamis értéket ad vissza, a társított *pfErrorCode érték SQLInstallerErrormeghívásával szerezhető be. Az alábbi táblázat felsorolja a *pfErrorCode értékeket, amelyeket SQLInstallerError adhat vissza, és mindegyiket a függvény kontextusában ismerteti.

*pfErrorCode	Hiba	Leírás
ODBC_ERROR_GENERAL_ERR	Általános telepítőhiba	Hiba történt, amelynél nem volt konkrét telepítőhiba.
ODBC_ERROR_REQUEST_FAILED	kérelem sikertelen volt	A ConfigDSN hívása sikertelen volt.
ODBC_ERROR_INVALID__HWND	Érvénytelen ablakleíró	A hwnd argumentum érvénytelen volt vagy NULL.
ODBC_ERROR_OUT_OF_MEM	Memóriakihasználtság	A telepítő memóriahiány miatt nem tudta végrehajtani a függvényt.

Adatforrások kezelése

SQLManageDataSources kezdetben az ODBC adatforrás-rendszergazdai párbeszédpanelt jeleníti meg az alábbi ábrán látható módon.

A párbeszédpanel három lapon jeleníti meg a rendszerinformációkban szereplő adatforrásokat: Felhasználói DSN, System DSNés Fájl DSN. Ha a felhasználó duplán kattint egy adatforrásra, vagy kiválaszt egy adatforrást, és a konfigurálása gombra kattint, SQLManageDataSources a beállítási DLL-ben a ODBC_CONFIG_DSN beállítással hívja meg ConfigDSN.

Ha a felhasználó hozzáadása elemre kattint, SQLManageDataSources megjeleníti az Új adatforrás létrehozása párbeszédpanelt, amely az alábbi ábrán látható.

A párbeszédpanelen megjelenik a telepített illesztőprogramok listája. Ha a felhasználó duplán kattint egy illesztőprogramra, vagy kiválaszt egy illesztőprogramot, és az OKgombra kattint, SQLManageDataSources meghívja ConfigDSN a telepítő DLL-ben, és átadja a ODBC_ADD_DSN lehetőséget.

Ha a felhasználó kiválaszt egy adatforrást, és a Eltávolításgombra kattint, SQLManageDataSources megkérdezi, hogy a felhasználó törölni szeretné-e az adatforrást. Ha a felhasználó az Igengombra kattint, SQLManageDataSources meghívja ConfigDSN a telepítő DLL-ben a ODBC_REMOVE_DSN beállítással.

A Új adatforrás létrehozása párbeszédpanelen felhasználói adatforrást, rendszeradatforrást vagy fájladatforrást vehet fel vagy törölhet.

Felhasználói DSN-k

Az egyes felhasználók számára létrehozott DSN-eket felhasználói DSN-eknek nevezzük, hogy meg lehessen különböztetni őket a rendszer DSN-jeitől. A felhasználói DSN-k a rendszerinformációkban az alábbiak szerint vannak regisztrálva:

HKEY_CURRENT_USERS

SOFTWARE

ODBC

Odbc.ini

Rendszer DSN-jei

Az Új adatforrás létrehozása párbeszédpanelen rendszeradatforrást vehet fel a helyi számítógépre, vagy törölhet egyet, vagy beállíthatja egy rendszeradatforrás konfigurációját.

A rendszeradatforrás-névvel (DSN) beállított adatforrásokat több felhasználó is használhatja ugyanazon a gépen. A rendszerszintű szolgáltatás is használhatja, amely így akkor is hozzáférhet az adatforráshoz, ha nincs bejelentkezve felhasználó a gépre.

A rendszer DSN-ét a rendszerinformációk HKEY_LOCAL_MACHINE bejegyzésében regisztrálja a rendszer, nem pedig a HKEY_CURRENT_USER bejegyzésben. Ez nem egy felhasználóhoz van kötve, aki a megadott felhasználónévvel és jelszóval jelentkezik be, de a gép bármely felhasználója vagy egy automatikus rendszerszintű szolgáltatás használhatja. A rendszer DSN-jének azonban egy géphez van kötve. Nem támogatja a távoli DSN-k gépek közötti használatát. A rendszer DSN-jei az alábbiak szerint vannak regisztrálva a rendszerinformációkban:

HKEY_LOCAL_MACHINE SOFTWARE ODBC Odbc.ini

Fájl DSN-jei

A fájl adatforrása nem rendelkezik adatforrásnévvel, csakúgy, mint egy gép adatforrása, és nincs regisztrálva egyetlen felhasználó vagy gép számára sem. Az adatforrás kapcsolati adatait egy .dsn fájl tartalmazza, amely bármely gépre másolható. A fájl adatforrás megosztható, ebben az esetben a .dsn fájl egy hálózaton található, és egyszerre több felhasználó is használhatja a hálózaton, feltéve, hogy a felhasználó rendelkezik a megfelelő illesztőprogramtal. A fájl adatforrások is oszthatatlanok lehetnek, ebben az esetben csak egyetlen gépen használhatók.

További információ a fájl adatforrásokról: Csatlakozás fájladatforrások használatával, vagy lásd SQLDriverConnect.

Illesztőprogramok kezelése

Ha a felhasználó az ODBC adatforrásgazda párbeszédpanelen az Illesztőprogramok fülre kattint, SQLManageDataSources megjeleníti a rendszeren telepített ODBC-illesztőprogramok listáját, valamint az illesztőprogramokkal kapcsolatos információkat. A megjelenített dátum az illesztőprogram létrehozási dátuma, ahogyan az az alábbi ábrán is látható.

Nyomkövetési beállítások

Ha a felhasználó a Nyomkövetés fülre kattint az ODBC adatforrás-rendszergazda párbeszédpanelen, AZ SQLManageDataSources megjeleníti a nyomkövetési beállításokat, ahogyan az az alábbi ábrán látható.

Ha a felhasználó a A nyomkövetés indítása, majd az OKgombra kattint, AZ SQLManageDataSources engedélyezi a manuális nyomkövetést a gépen jelenleg futó összes alkalmazáshoz.

Ha a felhasználó megadja egy nyomkövetési fájl nevét a Naplófájl elérési útja szövegmezőben, majd az OKgombra kattint, SQLManageDataSources beállítja a rendszerinformáció [ODBC] szakaszában található TraceFile kulcsszót a megadott névre.

Fontos

A Visual Studio Analyzer támogatása a Windows 8-tól kezdve el lett távolítva (a Visual Studio Analyzer csak a Visual Studio régebbi verzióiban volt elérhető). Alternatív hibaelhárítási mechanizmushoz használja a BID-nyomkövetést.

Ha a felhasználó Visual Studio Analyzer indítása, majd az OKgombra kattint, a Visual Studio Analyzer engedélyezve van. Mindaddig engedélyezve marad, amíg a Visual Studio Analyzer leállítása nem kattint.

További információ a nyomkövetésről: Nyomkövetési. A Trace és TraceFile kulcsszavakról további információt ODBC-alkulcs.

Kapcsolódó függvények

További információ:	Lát
Adatforrások létrehozása	SQLCreateDataSource