Partage via


Connexion avec SQLBrowseConnect

SQLBrowse Connecter, comme SQLDriver Connecter, utilise un chaîne de connexion. Toutefois, à l’aide de SQLBrowse Connecter, une application peut construire une chaîne de connexion complète au moment de l’exécution. L'application peut alors réaliser deux tâches :

  • Créez ses propres boîtes de dialogue pour demander ces informations, conservant ainsi le contrôle de son « apparence ».

  • Parcourir le système à la recherche de sources de données qu'un pilote en particulier peut exploiter, et ce éventuellement en plusieurs étapes. Par exemple, l'utilisateur peut d'abord rechercher des serveurs sur le réseau, puis après avoir choisi un serveur, recherchez sur ce dernier des bases de données auxquelles le pilote peut accéder.

L’application appelle SQLBrowse Connecter et transmet une chaîne de connexion, appelée chaîne de connexion de requête de navigation, qui spécifie un pilote ou une source de données. Le pilote retourne une chaîne de connexion, appelée chaîne de connexion de résultat de navigation, qui contient des mot clé, des valeurs possibles (si le mot clé accepte un ensemble discret de valeurs) et des noms conviviaux. L’application génère une boîte de dialogue avec les noms conviviaux et invite l’utilisateur à entrer des valeurs. Il génère ensuite une nouvelle requête de navigation chaîne de connexion à partir de ces valeurs et le retourne au pilote avec un autre appel à SQLBrowse Connecter.

Étant donné que les chaîne de connexion sont passées, le pilote peut fournir plusieurs niveaux de navigation en retournant une nouvelle chaîne de connexion lorsque l’application retourne l’ancienne. Par exemple, la première fois qu’une application appelle SQLBrowse Connecter, le pilote peut retourner des mot clé pour inviter l’utilisateur à entrer un nom de serveur. Lorsque l’application retourne le nom du serveur, le pilote peut retourner des mot clé pour inviter l’utilisateur à entrer une base de données. Le processus de navigation est terminé une fois que l’application a retourné le nom de la base de données.

Chaque fois que SQLBrowse Connecter retourne un nouveau résultat de navigation chaîne de connexion, il retourne SQL_NEED_DATA en tant que code de retour. Cela indique à l’application que le processus de connexion n’est pas terminé. Tant que SQLBrowse Connecter retourne SQL_SUCCESS, la connexion est dans un état de données besoin et ne peut pas être utilisée à d’autres fins, par exemple pour définir un attribut de connexion. L’application peut arrêter le processus de navigation de connexion en appelant SQLDisconnect.

Cette section contient la rubrique suivante.