Propiedades de inicialización y autorización
El proveedor OLE DB de SQL Server Native Client interpreta las propiedades de inicialización y autorización de OLE DB de la siguiente forma:
Id. de propiedad |
Descripción |
|---|---|
DBPROP_AUTH_CACHE_AUTHINFO |
El proveedor OLE DB de SQL Server Native Client no almacena en caché la información de autenticación. El proveedor OLE DB de SQL Server Native Client devuelve DB_S_ERRORSOCCURRED en un intento por establecer el valor de propiedad. El miembro dwStatus de la estructura DBPROP indica DBPROPSTATUS_NOTSUPPORTED. |
DBPROP_AUTH_ENCRYPT_PASSWORD |
El proveedor OLE DB de SQL Server Native Client usa los mecanismos de seguridad estándar de Microsoft SQL Server para ocultar las contraseñas. El proveedor OLE DB de SQL Server Native Client devuelve DB_S_ERRORSOCCURRED en un intento por establecer el valor de propiedad. El miembro dwStatus de la estructura DBPROP indica DBPROPSTATUS_NOTSUPPORTED. |
DBPROP_AUTH_INTEGRATED |
Si la propiedad DBPROP_AUTH_INTEGRATED está establecida en un puntero NULL, en una cadena NULL o en el valor 'SSPI' VT_BSTR, el proveedor OLE DB de SQL Server Native Client usa el modo de autenticación de Windows para autorizar el acceso del usuario a la base de datos de SQL Server especificada por las propiedades DBPROP_INIT_CATALOG y DBPROP_INIT_DATASOURCE. Si está establecida en VT_EMPTY, que es el valor predeterminado, se usa la seguridad de SQL Server. La contraseña y el inicio de sesión de SQL Server se especifican en las propiedades DBPROP_AUTH_PASSWORD y DBPROP_AUTH_USERID. |
DBPROP_AUTH_MASK_PASSWORD |
El proveedor OLE DB de SQL Server Native Client usa los mecanismos de seguridad estándar de SQL Server para ocultar las contraseñas. El proveedor OLE DB de SQL Server Native Client devuelve DB_S_ERRORSOCCURRED en un intento por establecer el valor de propiedad. El miembro dwStatus de la estructura DBPROP indica DBPROPSTATUS_NOTSUPPORTED. |
DBPROP_AUTH_PASSWORD |
Contraseña asignada a un inicio de sesión de SQL Server. Esta propiedad se usa cuando se selecciona la autenticación de SQL Server para autorizar el acceso a una base de datos de SQL Server. |
DBPROP_AUTH_PERSIST_ENCRYPTED |
El proveedor OLE DB de SQL Server Native Client no cifra la información de autenticación cuando se almacena. El proveedor OLE DB de SQL Server Native Client devuelve DB_S_ERRORSOCCURRED en un intento por establecer el valor de propiedad. El miembro dwStatus de la estructura DBPROP indica DBPROPSTATUS_NOTSUPPORTED. |
DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO |
El proveedor OLE DB de SQL Server Native Client conserva los valores de autenticación, incluida una imagen de una contraseña, si se le solicita que lo haga. No se proporciona cifrado. |
DBPROP_AUTH_USERID |
Inicio de sesión de SQL Server. Esta propiedad se usa cuando se selecciona la autenticación de SQL Server para autorizar el acceso a una base de datos de SQL Server. |
DBPROP_INIT_ASYNCH |
El proveedor OLE DB de SQL Server Native Client admite la iniciación asincrónica. Al establecer el bit DBPROPVAL_ASYNCH_INITIALIZE en la propiedad DBPROP_INIT_ASYNCH, IDBInitialize::Initialize se convierte en una llamada que no es de bloqueo. Para obtener más información, vea Realizar operaciones asincrónicas. |
DBPROP_INIT_CATALOG |
Nombre de una base de datos de SQL Server existente con la que debe establecerse la conexión. |
DBPROP_INIT_DATASOURCE |
Nombre de red de un servidor que ejecuta una instancia de Microsoft SQL Server. Si hay varias instancias de SQL Server ejecutándose en el equipo, para conectarse a una instancia específica de SQL Server, el valor DBPROP_INIT_DATASOURCE debe especificarse como \\ServerName\InstanceName. La secuencia de escape \\ se usa para la barra diagonal inversa. |
DBPROP_INIT_GENERALTIMEOUT |
Indica el número de segundos que deben transcurrir para que una solicitud, que no sea de inicialización del origen de datos ni de ejecución de comandos, supere el tiempo de espera. El valor 0 indica un tiempo de espera infinito. Los proveedores que funcionan a través de conexiones de red o en escenarios de transacción o distribuidos pueden admitir esta propiedad para informar a un componente dado de alta que agote el tiempo de espera en caso de una solicitud de larga duración. Los tiempos de espera para la inicialización del origen de datos y la ejecución de comandos aún se rigen por DBPROP_INIT_TIMEOUT y DBPROP_COMMANDTIMEOUT, respectivamente. DBPROP_INIT_GENERALTIMEOUT es de solo lectura y, si intenta establecerse, se devuelve el error dwstatus de DBPROPSTATUS_NOTSETTABLE. |
DBPROP_INIT_HWND |
Identificador de ventana de la aplicación que realiza la llamada. Es necesario un identificador de ventana válido para el cuadro de diálogo de inicialización que se muestra cuando se permite solicitar las propiedades de inicialización. |
DBPROP_INIT_IMPERSONATION_LEVEL |
El proveedor OLE DB de SQL Server Native Client no admite el ajuste de nivel de suplantación. El proveedor OLE DB de SQL Server Native Client devuelve DB_S_ERRORSOCCURRED en un intento por establecer el valor de propiedad. El miembro dwStatus de la estructura DBPROP indica DBPROPSTATUS_NOTSUPPORTED. |
DBPROP_INIT_LCID |
El proveedor OLE DB de SQL Server Native Client valida el identificador de configuración regional y devuelve un error si el identificador no es compatible o no está instalado en el cliente. |
DBPROP_INIT_LOCATION |
El proveedor OLE DB de SQL Server Native Client devuelve DB_S_ERRORSOCCURRED en un intento por establecer el valor de propiedad. El miembro dwStatus de la estructura DBPROP indica DBPROPSTATUS_NOTSUPPORTED. |
DBPROP_INIT_MODE |
El proveedor OLE DB de SQL Server Native Client devuelve DB_S_ERRORSOCCURRED en un intento por establecer el valor de propiedad. El miembro dwStatus de la estructura DBPROP indica DBPROPSTATUS_NOTSUPPORTED. |
DBPROP_INIT_PROMPT |
El proveedor OLE DB de SQL Server Native Client admite todos los modos de solicitud de inicialización del origen de datos. El proveedor OLE DB de SQL Server Native Client usa DBPROMPT_NOPROMPT como valor predeterminado para la propiedad. |
DBPROP_INIT_PROTECTION_LEVEL |
El proveedor OLE DB de SQL Server Native Client no admite un nivel de protección en las conexiones a instancias de SQL Server. El proveedor OLE DB de SQL Server Native Client devuelve DB_S_ERRORSOCCURRED en un intento por establecer el valor de propiedad. El miembro dwStatus de la estructura DBPROP indica DBPROPSTATUS_NOTSUPPORTED. |
DBPROP_INIT_PROVIDERSTRING |
Vea la cadena del proveedor OLE DB de SQL Server Native Client más adelante en este tema. |
DBPROP_INIT_TIMEOUT |
El proveedor OLE DB de SQL Server Native Client devuelve un error de inicialización si no puede establecerse una conexión con la instancia de SQL Server tras el número de segundos especificado. |
En el conjunto de propiedades específicas del proveedor DBPROPSET_SQLSERVERDBINIT, el proveedor OLE DB de SQL Server Native Client define estas propiedades de inicialización adicionales.
Id. de propiedad |
Descripción |
|---|---|
SSPROP_AUTH_OLD_PASSWORD |
Tipo: VT_BSTR L/E: escritura Valor predeterminado: VT_EMPTY Descripción: contraseña actual o expirada. Para obtener más información, vea Cambiar las contraseñas mediante programación. |
SSPROP_INIT_APPNAME |
Tipo: VT_BSTR L/E: lectura/escritura Descripción: nombre de la aplicación cliente. |
SSPROP_INIT_AUTOTRANSLATE |
Tipo: VT_BOOL L/E: lectura/escritura Valor predeterminado: VARIANT_TRUE Descripción: conversión de caracteres OEM/ANSI. VARIANT_TRUE: el proveedor OLE DB de SQL Server Native Client traduce cadenas de caracteres ANSI enviadas entre el cliente y el servidor mediante la conversión a través de Unicode para minimizar los problemas de caracteres extendidos coincidentes entre las páginas de códigos del cliente y del servidor: Los datos DBTYPE_STR del cliente enviados a una instancia de la variable, parámetro o columna char, varchar o text de SQL Server se convierten de carácter a Unicode mediante la página de códigos ANSI (ACP) del cliente y, después, se convierten de Unicode a carácter mediante la ACP del servidor. Los datos char, varchar o text de SQL Server enviados a una variable DBTYPE_STR del cliente se convierten de carácter a Unicode mediante la ACP del servidor y, después, se convierten de Unicode a carácter mediante la ACP del cliente. El proveedor OLE DB de SQL Server Native Client realiza estas conversiones en el cliente. Esto requiere que la misma ACP que se usa en el servidor esté disponible en el cliente. Esta configuración no tiene ningún efecto en las conversiones que se realizan para estas transferencias: Los datos de cliente DBTYPE_WSTR de Unicode enviados a char, varchar o text en el servidor. Los datos de servidor char, varchar o text enviados a una variable DBTYPE_WSTR de Unicode en el cliente. Los datos de cliente DBTYPE_STR de ANSI enviados a nchar, nvarchar o ntext de Unicode en el servidor. Los datos de servidor char, varchar o text de Unicode enviados a una variable DBTYPE_STR de ANSI en el cliente. VARIANT_FALSE: el proveedor OLE DB de SQL Server Native Client no realiza traducciones de caracteres. El proveedor OLE DB de SQL Server Native Client no traduce los datos DBTYPE_STR de caracteres ANSI del cliente enviados a variables, parámetros o columnas char, varchar o text en el servidor. No se realiza ninguna traducción en los datos char, varchar o text enviados del servidor a las variables DBTYPE_STR en el cliente. Si el cliente y la instancia de SQL Server están utilizando distintas ACP, pueden malinterpretarse los caracteres extendidos. |
SSPROP_INIT_CURRENTLANGUAGE |
Tipo: VT_BSTR L/E: lectura/escritura Descripción: nombre del lenguaje SQL Server. Identifica el lenguaje que se usa para la selección y el formato de mensajes del sistema. El lenguaje debe instalarse en el equipo que ejecuta una instancia de SQL Server o, de lo contrario, se producirá un error de inicialización del origen de datos. |
SSPROP_INIT_DATATYPECOMPATIBILITY |
Tipo: VT_UI2 L/E: lectura/escritura Valor predeterminado: 0 Descripción: habilita la compatibilidad de tipo de datos entre las aplicaciones SQL Server y las aplicaciones ADO (Objetos de datos ActiveX). Si se utiliza el valor predeterminado 0, la administración de tipos de datos usa el valor predeterminado del proveedor. Si se usa el valor 80, la administración de tipos de datos solo usa tipos de datos de SQL Server 2000. Para obtener más información, vea Usar ADO con SQL Server Native Client. |
SSPROP_INIT_ENCRYPT |
Tipo: VT_BOOL L/E: lectura/escritura Valor predeterminado: VARIANT_FALSE Descripción: para cifrar los datos que se envían a través de la red, la propiedad SSPROP_INIT_ENCRYPT se establece en VARIANT_TRUE. Si el cifrado de protocolo está habilitado, siempre se llevará a cabo el cifrado, independientemente del valor de SSPROP_INIT_ENCRYPT. Si no está habilitado y la propiedad SSPROP_INIT_ENCRYPT está establecida en VARIANT_TRUE, se llevará a cabo el cifrado. Si el cifrado de protocolo no está habilitado y la propiedad SSPROP_INIT_ENCRYPT está establecida en VARIANT_FALSE, no se lleva a cabo el cifrado. |
SSPROP_INIT_FAILOVERPARTNER |
Tipo: VT_BSTR L/E: lectura/escritura Descripción: especifica el nombre del asociado de conmutación por error para la creación de reflejo de la base de datos. Se trata de una propiedad de inicialización y solo puede establecerse antes de la inicialización. Tras la inicialización, devolverá el asociado de conmutación por error devuelto por el servidor principal, si existe. Esto permite que una aplicación inteligente almacene en memoria caché el servidor de copia de seguridad determinado más recientemente, pero dichas aplicaciones deben tener en cuenta que la información solo se actualiza cuando la conexión se establece por primera vez (o se restablece, si está agrupada) y puede quedar desfasada para conexiones a largo plazo. Después de realizar la conexión, la aplicación puede consultar este atributo para determinar la identidad del asociado de conmutación por error. Si el servidor principal no tiene ningún asociado de conmutación por error, esta propiedad devolverá una cadena vacía. Para obtener más información, vea Usar la creación de reflejo de bases de datos. |
SSPROP_INIT_FILENAME |
Tipo: VT_BSTR L/E: lectura/escritura Descripción: especifica el nombre del archivo principal de una base de datos adjuntable. Esta base de datos se adjunta y se convierte en la base de datos predeterminada para la conexión. Para usar SSPROP_INIT_FILENAME, debe especificar el nombre de la base de datos como el valor de la propiedad de inicialización DBPROP_INIT_CATALOG. Si el nombre de la base de datos no existe, entonces busca el nombre de archivo principal especificado en SSPROP_INIT_FILENAME y adjunta esa base de datos al nombre especificado en DBPROP_INIT_CATALOG. Si la base de datos se ha adjuntado previamente, SQL Server no vuelve a adjuntarla. |
SSPROP_INIT_MARSCONNECTION |
Tipo: VT_BOOL L/E: lectura/escritura Valor predeterminado: VARIANT_FALSE Descripción: especifica si los conjuntos de resultados activos múltiples (MARS) están habilitados para la conexión. Esta opción debe establecerse en True antes de realizar cualquier conexión a la base de datos. Para obtener más información, vea Utilizar conjuntos de resultados activos múltiples (MARS). |
SSPROP_INIT_NETWORKADDRESS |
Tipo: VT_BSTR L/E: lectura/escritura Descripción: dirección de red del servidor que ejecuta una instancia de SQL Server especificada por la propiedad DBPROP_INIT_DATASOURCE. |
SSPROP_INIT_NETWORKLIBRARY |
Tipo: VT_BSTR L/E: lectura/escritura Descripción: nombre de la biblioteca de red (DLL) utilizada para comunicarse con una instancia de SQL Server. El nombre no debe incluir la ruta de acceso ni la extensión de nombre de archivo .dll. El valor predeterminado puede personalizarse mediante la utilidad de configuración del cliente de SQL Server.
|
SSPROP_INIT_PACKETSIZE |
Tipo: VT_I4 L/E: lectura/escritura Descripción: tamaño del paquete de red en bytes. El valor de la propiedad de tamaño de paquete debe estar comprendido entre 512 y 32.767. El tamaño predeterminado de los paquetes de red del proveedor OLE DB de SQL Server Native Client es 4.096. |
SSPROP_INIT_TAGCOLUMNCOLLATION |
Tipo: BOOL L/E: escritura Valor predeterminado: FALSE Descripción: se usa durante una actualización de base de datos cuando se utilizan cursores del servidor. Esta propiedad etiqueta los datos con la información de intercalación obtenida del servidor en lugar de la página de códigos del cliente. Actualmente, solo utiliza esta propiedad el proceso de consulta distribuida, puesto que conoce la intercalación de datos del destino y la convierte correctamente. |
SSPROP_INIT_TRUST_SERVER_CERTIFICATE |
Tipo: VT_BOOL L/E: lectura/escritura Valor predeterminado: VARIANT_FALSE Descripción: se usa para habilitar o deshabilitar la validación de certificados del servidor. Esta propiedad es de lectura/escritura, pero cualquier intento por establecerla una vez que se haya establecido una conexión generará un error. Esta propiedad se omite si el cliente se configura de modo que requiere validación de certificados. Sin embargo, una aplicación puede usarla junto con SSPROP_INIT_ENCRYPT para garantizar que su conexión al servidor esté cifrada, aunque la configuración del cliente no requiera cifrado y en el cliente no se proporcione ningún certificado. Las aplicaciones cliente podrán consultar esta propiedad una vez que se haya abierto una conexión para determinar la configuración real de cifrado y validación que se está usando.
Para obtener más información, vea Utilizar el cifrado sin validación. |
SSPROP_INIT_USEPROCFORPREP |
Tipo: VT_I4 L/E: lectura/escritura Valor predeterminado: SSPROPVAL_USEPROCFORPREP_ON Descripción: uso de procedimientos almacenados de SQL Server. Define el uso de procedimientos almacenados temporales de SQL Server para admitir la interfaz ICommandPrepare. Esta propiedad solo era significativa al establecer una conexión a SQL Server 6.5. se omite en versiones posteriores. SSPROPVAL_USEPROCFORPREP_OFF: no se crea un procedimiento almacenado temporal cuando se prepara un comando. SSPROPVAL_USEPROCFORPREP_ON: se crea un procedimiento almacenado temporal cuando se prepara un comando. Cuando se libera la sesión, se quitan los procedimientos almacenados temporales. SSPROPVAL_USEPROCFORPREP_ON_DROP: se crea un procedimiento almacenado temporal cuando se prepara un comando. El procedimiento se quita cuando el comando no se ha preparado con ICommandPrepare::Unprepare, cuando se especifica un nuevo comando para el objeto de comando con ICommandText::SetCommandText o cuando se liberan todas las referencias de la aplicación al comando. |
SSPROP_INIT_WSID |
Tipo: VT_BSTR L/E: lectura/escritura Descripción: cadena que identifica la estación de trabajo. |
En el conjunto de propiedades específicas del proveedor SQLSERVERDATASOURCEINFO, el proveedor OLE DB de SQL Server Native Client define las propiedades adicionales; para obtener más información, vea Propiedades de información de orígenes de datos.
Cadena del proveedor OLE DB de SQL Server Native Client
El proveedor OLE DB de SQL Server Native Client reconoce una sintaxis similar a la de ODBC en los valores de propiedad de cadena del proveedor. La propiedad de cadena del proveedor se proporciona como valor de la propiedad de inicialización de OLE DB DBPROP_INIT_PROVIDERSTRING cuando se establece una conexión con el origen de datos OLE DB. Esta propiedad especifica los datos de conexión específicos del proveedor OLE DB necesarios para implementar una conexión con el origen de datos OLE DB. Dentro de la cadena, los elementos están delimitados mediante un punto y coma. El último elemento de la cadena debe terminar con un punto y coma. Cada elemento consta de una palabra clave, un carácter de signo igual y el valor que se pasó en la inicialización. Por ejemplo:
Server=MyServer;UID=MyUserName;
Con el proveedor OLE DB de SQL Server Native Client, el consumidor no necesita usar nunca la propiedad de cadena del proveedor. El consumidor puede establecer cualquier propiedad de inicialización reflejada en la cadena del proveedor mediante las propiedades de inicialización específicas del proveedor OLE DB de SQL Server Native Client o de OLE DB.
Para obtener una lista de las palabras clave disponibles en el proveedor OLE DB de SQL Server Native Client, vea Usar palabras clave de cadena de conexión con SQL Server Native Client.