SQLBrowseConnect

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

SQLBrowse Conectar 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 SQLBrowse Conectar.
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.

SQLBrowse Conectar 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 SQLBrowse Conectar no es válido, SQLBrowse Conectar devuelve SQL_NEED_DATA y los atributos de conexión de nivel 3.

Los atributos siguientes, que se establecen mediante una llamada a SQLSet Conectar Attr, determinan el conjunto de resultados devuelto por SQLBrowse Conectar.

Atributo	Descripción
SQL_COPT_SS_BROWSE_CONNECT	Si se establece en SQL_MORE_INFO_YES, SQLBrowse Conectar devuelve una cadena extendida de propiedades del servidor. A continuación se muestra un ejemplo de una cadena extendida devuelta por SQLBrowse Conectar: 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, SQLBrowse Conectar devolverá información para el servidor especificado. Si SQL_COPT_SS_BROWSE_SERVER se establece en NULL, SQLBrowse Conectar devuelve información de todos los servidores del dominio. Tenga en cuenta que debido a problemas de red, SQLBrowse Conectar 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 SQLBrowse Conectar. 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 SQLBrowse Conectar 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 Conectar ions 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