SQLBrowseConnect

Se aplica a: SQL Server Azure SQL Database Azure SQL Instancia administrada Azure Synapse Analytics Analytics Platform System (PDW)

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	¿Se devuelve una lista?	¿Es opcional?	Descripción
DSN	N/D	No	Nombre del origen de datos devuelto por SQLDataSources. No se puede utilizar la palabra clave DSN si se utiliza la palabra clave DRIVER.
DRIVER	N/D	No	El nombre del controlador ODBC de SQL Server Native Client es {SQL Server Native Client 11}. No se puede utilizar la palabra clave DRIVER si se utiliza la palabra clave DSN.

Nivel 2

Palabra clave	¿Se devuelve una lista?	¿Es opcional?	Descripción
SERVER	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.
UID	No	Sí	Id. de inicio de sesión de usuario.
PWD	No	Sí (depende del usuario)	Contraseña especificada por el usuario.
APP	No	Sí	Nombre de la aplicación que llama a SQLBrowseConnect.
WSID	No	Sí	Id. de estación de trabajo. Normalmente, éste es el nombre de red del equipo en el que se ejecuta la aplicación.

Nivel 3

Palabra clave	¿Se devuelve una lista?	¿Es opcional?	Descripción
DATABASE	Sí	Sí	Nombre de la base de datos de SQL Server.
LANGUAGE	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 el cadena de conexión pasado 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;Clustered:No;Version:8.00.131 En esta cadena, se utilizan signos de punto y coma para separar distintas partes de información acerca del servidor. Use comas para separar distintas instancias del 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. Tenga en cuenta que debido a problemas de red, SQLBrowseConnect podría no recibir una respuesta oportuna de todos los servidores. Por lo tanto, la lista de servidores devuelta puede variar para cada solicitud.
SQL_COPT_SS_BROWSE_CACHE_DATA	Cuando el atributo SQL_COPT_SS_BROWSE_CACHE_DATA está establecido en SQL_CACHE_DATA_YES, es posible para capturar los datos en fragmentos si la longitud del búfer no es lo suficientemente grande como para albergar 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 para la alta disponibilidad con recuperación de 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 de SQL Server Native Client con alta disponibilidad y recuperación ante desastres.

Compatibilidad de SQLBrowseConnect con los Nombres principales 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
Se ha documentado SQL_COPT_SS_BROWSE_CACHE_DATA.

Consulte también

Función SQLBrowseConnect
Detalles de implementación de la API de ODBC