Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
SQLBrowseConnect usa palabras clave que se pueden clasificar en tres niveles de información de conexión. Para cada palabra clave, la tabla siguiente indica si se devuelve una lista de valores válidos y si la palabra clave es opcional.
Nivel 1
| Palabra clave | ¿Lista devuelta? | ¿Es opcional? | Descripción |
|---|---|---|---|
| DSN | No disponible | No | Nombre del origen de datos devuelto por SQLDataSources. La palabra clave DSN no se puede usar si se usa la palabra clave DRIVER. |
| CONDUCTOR | No disponible | No | ¿¿Microsoft?? El nombre del controlador ODBC de SQL Server Native Client es {SQL Server Native Client 11}. La palabra clave DRIVER no se puede usar si se usa la palabra clave DSN. |
Nivel 2
| Palabra clave | ¿Lista devuelta? | ¿Es opcional? | Descripción |
|---|---|---|---|
| SERVIDOR | Sí | No | Nombre del servidor en la red en la que reside el origen de datos. El término "(local)" se puede escribir como servidor, en cuyo caso se puede usar una copia local de SQL Server, incluso cuando se trata de una versión no en red. |
| Identificador Único | No | Sí | Identificador de inicio de sesión de usuario. |
| PWD | No | Sí (depende del usuario) | Contraseña especificada por el usuario. |
| APLICACIÓN | No | Sí | Nombre de la aplicación que llama a SQLBrowseConnect. |
| WSID | No | Sí | Id. de estación de trabajo. Normalmente, este es el nombre de red del equipo en el que se ejecuta la aplicación. |
Nivel 3
| Palabra clave | ¿Lista devuelta? | ¿Es opcional? | Descripción |
|---|---|---|---|
| BASE DE DATOS | Sí | Sí | Nombre de la base de datos de SQL Server. |
| IDIOMA | Sí | Sí | Idioma nacional usado por SQL Server. |
SQLBrowseConnect omite los valores de las palabras clave DATABASE y LANGUAGE almacenadas en las definiciones del origen de datos ODBC. Si la base de datos o el idioma especificados en la cadena de conexión que se pasa a SQLBrowseConnect no es válido, SQLBrowseConnect devuelve SQL_NEED_DATA y los atributos de conexión de nivel 3.
Los atributos siguientes, que se establecen mediante una llamada a SQLSetConnectAttr, determinan el conjunto de resultados devuelto por SQLBrowseConnect.
| Atributo | Descripción |
|---|---|
| SQL_COPT_SS_BROWSE_CONNECT | Si se establece en SQL_MORE_INFO_YES, SQLBrowseConnect devuelve una cadena extendida de propiedades del servidor. A continuación se muestra un ejemplo de una cadena extendida devuelta por SQLBrowseConnect:ServerName\InstanceName; Agrupado:No; Versión:8.00.131 En esta cadena, los punto y coma separan varios fragmentos de información sobre el servidor. Use comas para separar diferentes instancias de servidor. |
| SQL_COPT_SS_BROWSE_SERVER | Si se especifica un nombre de servidor, SQLBrowseConnect devolverá información para el servidor especificado. Si SQL_COPT_SS_BROWSE_SERVER está establecido en NULL, SQLBrowseConnect devuelve información para todos los servidores del dominio. Debido a problemas de red, SQLBrowseConnect podría no recibir una respuesta oportuna de todos los servidores. Por lo tanto, la lista de servidores devueltos puede variar para cada solicitud. |
| SQL_COPT_SS_BROWSE_CACHE_DATA | Cuando el atributo SQL_COPT_SS_BROWSE_CACHE_DATA se establece en SQL_CACHE_DATA_YES, puede capturar datos en fragmentos cuando la longitud del búfer no es lo suficientemente grande como para contener el resultado. Esta longitud se especifica en el argumento BufferLength en SQLBrowseConnect. SQL_NEED_DATA se devuelve cuando hay más datos disponibles. SQL_SUCCESS se devuelve cuando no hay más datos que recuperar. El valor predeterminado es SQL_CACHE_DATA_NO. |
Compatibilidad de SQLBrowseConnect con alta disponibilidad y recuperación ante desastres
Para obtener más información sobre el uso de SQLBrowseConnect para conectarse a un clúster de grupos de disponibilidad AlwaysOn, consulte Compatibilidad con SQL Server Native Client para alta disponibilidad y recuperación ante desastres.
Compatibilidad de SQLBrowseConnect con nombres de entidad de seguridad de servicio (SPN)
Cuando se abre una conexión, SQL Server Native Client establece SQL_COPT_SS_MUTUALLY_AUTHENTICATED y SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD al método de autenticación que se usa para abrir la conexión.
Para obtener más información sobre los SPN, consulte Nombres de entidad de seguridad de servicio (SPN) en Conexiones de cliente (ODBC).
Historial de cambios
| Contenido actualizado |
|---|
| SQL_COPT_SS_BROWSE_CACHE_DATA documentados. |
Véase también
Función SQLBrowseConnect
Detalles de implementación de la API de ODBC