Compartir a través de


SQLBrowseConnect

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 de controlador ODBC de Microsoft® SQL Server Native Client es {SQL Server Native Client 10}. 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

No

Nombre del servidor en la red en la que reside el origen de datos. El término"(local)" se puede escribir como el servidor, en cuyo caso se puede utilizar una copia local de SQL Server, incluso cuando se trata de una versión que no está en red.

UID

No

Id. de inicio de sesión de usuario.

PWD

No

Sí (depende del usuario)

Contraseña especificada por el usuario.

APP

No

Nombre de la aplicación que llama a SQLBrowseConnect.

WSID

No

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

Nombre de la base de datos de SQL Server.

LANGUAGE

Lenguaje nacional utilizado por SQL Server.

SQLBrowseConnect omite los valores de las palabras clave LANGUAGE y DATABASE almacenados en las definiciones del origen de datos ODBC. Si la base de datos o el lenguaje especificados en la cadena de conexión pasada a SQLBrowseConnect no son válidos, SQLBrowseConnect devuelve SQL_NEED_DATA y los atributos de conexión de nivel 3.

Los atributos siguientes, que se establecen llamando a SQLSetConnectAttr, determinan el conjunto de resultados devuelto por SQLBrowseConnect.

Atributo

Descripción

SQL_COPT_SS_BROWSE_CONNECT

Si está establecido en SQL_MORE_INFO_YES en SQL Server 2000 y posteriores, SQLBrowseConnect devuelve una cadena extendida de propiedades del servidor.

A continuación se muestra un ejemplo de una cadena extendida devuelta por SQLBrowseConnect en SQL Server 2000:

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 devuelve información del servidor especificado. Si SQL_COPT_SS_BROWSE_SERVER está establecido en NULL, SQLBrowseConnect devuelve información de todos los servidores del dominio.

NotaNota
SQLBrowseConnect podría no recibir una respuesta a tiempo de todos los servidores debido a problemas de red. 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 a 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 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 en el método de autenticación que se usa para abrir la conexión.

Para obtener más información acerca de los SPN, vea Nombres de entidad de seguridad del servicio (SPN) en conexiones de cliente (ODBC).