SQLBrowseConnect(如 SQLDriverConnect)使用连接字符串。 但是,通过使用 SQLBrowseConnect,应用程序可以在运行时构造完整的连接字符串。 这允许应用程序执行两项作:
生成自己的对话框以提示输入此信息,从而保留对其“外观”的控制。
浏览系统以获取特定驱动程序可以使用的数据源,可能需执行几个步骤。 例如,用户可能首先浏览服务器的网络,在选择服务器后,浏览服务器以获取驱动程序可访问的数据库。
应用程序调用 SQLBrowseConnect 并传递一个连接字符串,称为 浏览请求连接字符串,该连接字符串 指定驱动程序或数据源。 驱动程序返回一个连接字符串,称为 浏览结果连接字符串, 其中包含关键字、可能的值(如果关键字接受一组离散值)和用户友好名称。 应用程序生成一个具有用户友好名称的对话框,并提示用户输入值。 然后,它会从这些值生成新的浏览请求连接字符串,并使用对 SQLBrowseConnect 的另一个调用将此字符串返回到驱动程序。
由于连接字符串是来回传递的,因此当应用程序返回旧连接字符串时,驱动程序可以通过返回新的连接字符串来提供多个级别的浏览。 例如,应用程序首次调用 SQLBrowseConnect 时,驱动程序可能会返回关键字来提示用户输入服务器名称。 当应用程序返回服务器名称时,驱动程序可能会返回关键字以提示用户输入数据库。 应用程序返回数据库名称后,浏览过程将完成。
每次 SQLBrowseConnect 返回新的浏览结果连接字符串时,它都会返回SQL_NEED_DATA作为返回代码。 这会告知应用程序连接过程未完成。 在 SQLBrowseConnect 返回SQL_SUCCESS之前,连接处于“需要数据”状态,不能用于其他目的,例如设置连接属性。 应用程序可以通过调用 SQLDisconnect 终止连接浏览过程。
本节包含以下主题。