Megosztás:


Csatlakozás az SQLBrowseConnect-hez

Az SQLBrowseConnect, például az SQLDriverConnect egy kapcsolati sztringet használ. Az SQLBrowseConnect használatával azonban egy alkalmazás futásidőben létrehozhat egy teljes kapcsolati sztringet. Ez két dolgot tesz lehetővé az alkalmazás számára:

  • Saját párbeszédpaneleket hozhat létre, hogy rákérdezhessenek ezekre az információkra, ezáltal megőrizve az irányítást a "megjelenés és érzés" felett.

  • Keresse meg a rendszert az adott illesztőprogram által használható adatforrások között, akár több lépésben is. Előfordulhat például, hogy a felhasználó először a kiszolgálók hálózatában tallózik, majd a kiszolgáló kiválasztása után megkeresi a kiszolgálót az illesztőprogram által elérhető adatbázisok között.

Az alkalmazás meghívja az SQLBrowseConnect-et, és átad egy kapcsolati karakterláncot, más néven a tallózási kérelem kapcsolati karakterláncát, amely egy illesztőprogramot vagy adatforrást határoz meg. Az illesztő visszaad egy kapcsolati sztringet, más néven a tallózási eredmény kapcsolati sztringjét, amely kulcsszavakat, lehetséges értékeket (ha a kulcsszó különálló értékkészletet fogad el) és felhasználóbarát neveket tartalmaz. Az alkalmazás létrehoz egy párbeszédpanelt a felhasználóbarát névvel, és kéri a felhasználót az értékek megadására. Ezután létrehoz egy új tallózáskérési kapcsolati sztringet ezekből az értékekből, és visszaadja ezt az illesztőnek az SQLBrowseConnect másik hívásával.

Mivel a kapcsolati sztringek oda-vissza vannak továbbítva, az illesztő több szintű böngészést is biztosíthat, ha egy új kapcsolati sztringet ad vissza, amikor az alkalmazás visszaadja a régit. Például amikor egy alkalmazás először hívja meg az SQLBrowseConnect-et, az illesztőprogram kulcsszavakat adhat vissza, hogy kérje a felhasználót egy kiszolgálónév megadásához. Amikor az alkalmazás visszaadja a kiszolgáló nevét, előfordulhat, hogy az illesztőprogram kulcsszavakat ad vissza, hogy kérje a felhasználótól az adatbázist. A böngészési folyamat akkor fejeződik be, ha az alkalmazás visszaadta az adatbázis nevét.

Minden alkalommal, amikor az SQLBrowseConnect egy új tallózási eredménykapcsolati sztringet ad vissza, az SQL_NEED_DATA return kódként tér vissza. Ez azt jelzi az alkalmazásnak, hogy a csatlakozási folyamat nem fejeződött be. Amíg az SQLBrowseConnect SQL_SUCCESS nem ad vissza, a kapcsolat adatszükségleti állapotban van, és nem használható más célokra, például kapcsolatattribútum beállítására. Az alkalmazás az SQLDisconnect meghívásával megszakíthatja a kapcsolat böngészési folyamatát.

Ez a szakasz az alábbi témakört tartalmazza.