Propiedades de inicialización y autorizaciónInitialization and Authorization Properties

SE APLICA A: síSQL Server síAzure SQL Database síAzure SQL Data Warehouse síAlmacenamiento de datos paralelos APPLIES TO: yesSQL Server yesAzure SQL Database yesAzure SQL Data Warehouse yesParallel Data Warehouse

El proveedor OLE DB de SQL ServerSQL Server Native Client interpreta las propiedades de inicialización y autorización de OLE DB de la siguiente forma:The SQL ServerSQL Server Native Client OLE DB provider interprets OLE DB initialization and authorization properties as follows:

Id. de propiedadProperty ID DescripciónDescription
DBPROP_AUTH_CACHE_AUTHINFODBPROP_AUTH_CACHE_AUTHINFO El proveedor OLE DB de SQL ServerSQL Server Native Client no almacena en caché la información de autenticación.The SQL ServerSQL Server Native Client OLE DB provider does not cache authentication information.

El proveedor OLE DB de SQL ServerSQL Server Native Client devuelve DB_S_ERRORSOCCURRED en un intento por establecer el valor de propiedad.The SQL ServerSQL Server Native Client OLE DB provider returns DB_S_ERRORSOCCURRED on an attempt to set the property value. El miembro dwStatus de la estructura DBPROP indica DBPROPSTATUS_NOTSUPPORTED.The dwStatus member of the DBPROP Structure indicates DBPROPSTATUS_NOTSUPPORTED.
DBPROP_AUTH_ENCRYPT_PASSWORDDBPROP_AUTH_ENCRYPT_PASSWORD El SQL ServerSQL Server proveedor OLE DB de Native Client utiliza estándar MicrosoftMicrosoft SQL ServerSQL Server mecanismos de seguridad para ocultar las contraseñas.The SQL ServerSQL Server Native Client OLE DB provider uses standard MicrosoftMicrosoftSQL ServerSQL Server security mechanisms to conceal passwords.

El proveedor OLE DB de SQL ServerSQL Server Native Client devuelve DB_S_ERRORSOCCURRED en un intento por establecer el valor de propiedad.The SQL ServerSQL Server Native Client OLE DB provider returns DB_S_ERRORSOCCURRED on an attempt to set the property value. El miembro dwStatus de la estructura DBPROP indica DBPROPSTATUS_NOTSUPPORTED.The dwStatus member of the DBPROP Structure indicates DBPROPSTATUS_NOTSUPPORTED.
DBPROP_AUTH_INTEGRATEDDBPROP_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 ServerSQL Server Native Client usa el modo de autenticación de Windows para autorizar el acceso del usuario a la base de datos de SQL ServerSQL Server especificada por las propiedades DBPROP_INIT_CATALOG y DBPROP_INIT_DATASOURCE.If DBPROP_AUTH_INTEGRATED is set to a NULL pointer, a null string, or 'SSPI' VT_BSTR value, the SQL ServerSQL Server Native Client OLE DB provider uses Windows Authentication Mode to authorize user access to the SQL ServerSQL Server database specified by the DBPROP_INIT_DATASOURCE and DBPROP_INIT_CATALOG properties.

Si está establecida en VT_EMPTY, que es el valor predeterminado, se usa la seguridad de SQL ServerSQL Server.If it is set to VT_EMPTY (the default), SQL ServerSQL Server security is used. La contraseña y el inicio de sesión de SQL ServerSQL Server se especifican en las propiedades DBPROP_AUTH_PASSWORD y DBPROP_AUTH_USERID.The SQL ServerSQL Server login and password are specified in the DBPROP_AUTH_USERID and DBPROP_AUTH_PASSWORD properties.
DBPROP_AUTH_MASK_PASSWORDDBPROP_AUTH_MASK_PASSWORD El proveedor OLE DB de SQL ServerSQL Server Native Client usa los mecanismos de seguridad estándar de SQL ServerSQL Server para ocultar las contraseñas.The SQL ServerSQL Server Native Client OLE DB provider uses standard SQL ServerSQL Server security mechanisms to conceal passwords.

El proveedor OLE DB de SQL ServerSQL Server Native Client devuelve DB_S_ERRORSOCCURRED en un intento por establecer el valor de propiedad.The SQL ServerSQL Server Native Client OLE DB provider returns DB_S_ERRORSOCCURRED on an attempt to set the property value. El miembro dwStatus de la estructura DBPROP indica DBPROPSTATUS_NOTSUPPORTED.The dwStatus member of the DBPROP Structure indicates DBPROPSTATUS_NOTSUPPORTED.
DBPROP_AUTH_PASSWORDDBPROP_AUTH_PASSWORD Contraseña asignada a un inicio de sesión de SQL ServerSQL Server.Password assigned to a SQL ServerSQL Server login. Esta propiedad se usa cuando se selecciona la autenticación de SQL ServerSQL Server para autorizar el acceso a una base de datos de SQL ServerSQL Server.This property is used when SQL ServerSQL Server Authentication is selected for authorizing access to a SQL ServerSQL Server database.
DBPROP_AUTH_PERSIST_ENCRYPTEDDBPROP_AUTH_PERSIST_ENCRYPTED El proveedor OLE DB de SQL ServerSQL Server Native Client no cifra la información de autenticación cuando se almacena.The SQL ServerSQL Server Native Client OLE DB provider does not encrypt authentication information when persisted.

El proveedor OLE DB de SQL ServerSQL Server Native Client devuelve DB_S_ERRORSOCCURRED en un intento por establecer el valor de propiedad.The SQL ServerSQL Server Native Client OLE DB provider returns DB_S_ERRORSOCCURRED on an attempt to set the property value. El miembro dwStatus de la estructura DBPROP indica DBPROPSTATUS_NOTSUPPORTED.The dwStatus member of the DBPROP Structure indicates DBPROPSTATUS_NOTSUPPORTED.
DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFODBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO El proveedor OLE DB de SQL ServerSQL Server Native Client conserva los valores de autenticación, incluida una imagen de una contraseña, si se le solicita que lo haga.The SQL ServerSQL Server Native Client OLE DB provider persists authentication values, including an image of a password, if requested to do so. No se proporciona cifrado.No encryption is provided.
DBPROP_AUTH_USERIDDBPROP_AUTH_USERID Inicio de sesión de SQL ServerSQL Server.SQL ServerSQL Server login. Esta propiedad se usa cuando se selecciona la autenticación de SQL ServerSQL Server para autorizar el acceso a una base de datos de SQL ServerSQL Server.This property is used when SQL ServerSQL Server Authentication is selected for authorizing access to a SQL ServerSQL Server database.
DBPROP_INIT_ASYNCHDBPROP_INIT_ASYNCH El proveedor OLE DB de SQL ServerSQL Server Native Client admite la iniciación asincrónica.The SQL ServerSQL Server Native Client OLE DB provider supports asynchronous initiation.

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.Setting the DBPROPVAL_ASYNCH_INITIALIZE bit in the DBPROP_INIT_ASYNCH property causes IDBInitialize::Initialize to become a non-blocking call. Para obtener más información, consulte realizar operaciones asincrónicas.For more information, see Performing Asynchronous Operations.
DBPROP_INIT_CATALOGDBPROP_INIT_CATALOG Nombre de una base de datos de SQL ServerSQL Server existente con la que debe establecerse la conexión.Name of an existing SQL ServerSQL Server database to which to connect.
DBPROP_INIT_DATASOURCEDBPROP_INIT_DATASOURCE Nombre de red de un servidor que ejecuta una instancia de MicrosoftMicrosoft SQL ServerSQL Server.Network name of a server running an instance of MicrosoftMicrosoftSQL ServerSQL Server. Si hay varias instancias de SQL ServerSQL Server ejecutándose en el equipo, para conectarse a una instancia específica de SQL ServerSQL Server, el valor DBPROP_INIT_DATASOURCE tiene que especificarse como \\NombreDeServidor\NombreDeInstancia.If there are multiple instances of SQL ServerSQL Server running on the computer, in order to connect to a specific instance of SQL ServerSQL Server the value DBPROP_INIT_DATASOURCE is specified as \\ServerName\InstanceName. La secuencia de escape \\ se usa para la barra diagonal inversa.The escape sequence \\ is used for backslash itself.
DBPROP_INIT_GENERALTIMEOUTDBPROP_INIT_GENERALTIMEOUT Indica el número de segundos antes de la solicitud, aparte del origen de datos de inicialización y ejecución del comando, se agota. El valor 0 indica un tiempo 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 de un componente dado de alta en tiempo de espera en caso de una solicitud de ejecución prolongada.Indicates the number of seconds before a request, other than data source initialization and command execution, times out. A value of 0 indicates an infinite time-out. Providers that work over network connections or in distributed or transacted scenarios can support this property to advise an enlisted component to time-out in the event of a long-running request. 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.Time-outs for data source initialization and command execution remain governed by DBPROP_INIT_TIMEOUT and DBPROP_COMMANDTIMEOUT, respectively.

DBPROP_INIT_GENERALTIMEOUT es de solo lectura y, si intenta establecerse, se devuelve el error dwstatus de DBPROPSTATUS_NOTSETTABLE.DBPROP_INIT_GENERALTIMEOUT is read-only, and if one tries to set it the dwstatus error of DBPROPSTATUS_NOTSETTABLE is returned.
DBPROP_INIT_HWNDDBPROP_INIT_HWND Identificador de ventana de la aplicación que realiza la llamada.The Windows handle from the calling application. 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.A valid window handle is required for the initialization dialog box displayed when prompting for initialization properties is allowed.
DBPROP_INIT_IMPERSONATION_LEVELDBPROP_INIT_IMPERSONATION_LEVEL El proveedor OLE DB de SQL ServerSQL Server Native Client no admite el ajuste de nivel de suplantación.The SQL ServerSQL Server Native Client OLE DB provider does not support impersonation level adjustment.

El proveedor OLE DB de SQL ServerSQL Server Native Client devuelve DB_S_ERRORSOCCURRED en un intento por establecer el valor de propiedad.The SQL ServerSQL Server Native Client OLE DB provider returns DB_S_ERRORSOCCURRED on an attempt to set the property value. El miembro dwStatus de la estructura DBPROP indica DBPROPSTATUS_NOTSUPPORTED.The dwStatus member of the DBPROP Structure indicates DBPROPSTATUS_NOTSUPPORTED.
DBPROP_INIT_LCIDDBPROP_INIT_LCID El proveedor OLE DB de SQL ServerSQL 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.The SQL ServerSQL Server Native Client OLE DB provider validates the locale ID and returns an error if the locale ID is not supported or is not installed on the client.
DBPROP_INIT_LOCATIONDBPROP_INIT_LOCATION El proveedor OLE DB de SQL ServerSQL Server Native Client devuelve DB_S_ERRORSOCCURRED en un intento por establecer el valor de propiedad.The SQL ServerSQL Server Native Client OLE DB provider returns DB_S_ERRORSOCCURRED on an attempt to set the property value. El miembro dwStatus de la estructura DBPROP indica DBPROPSTATUS_NOTSUPPORTED.The dwStatus member of the DBPROP Structure indicates DBPROPSTATUS_NOTSUPPORTED.
DBPROP_INIT_MODEDBPROP_INIT_MODE El proveedor OLE DB de SQL ServerSQL Server Native Client devuelve DB_S_ERRORSOCCURRED en un intento por establecer el valor de propiedad.The SQL ServerSQL Server Native Client OLE DB provider returns DB_S_ERRORSOCCURRED on an attempt to set the property value. El miembro dwStatus de la estructura DBPROP indica DBPROPSTATUS_NOTSUPPORTED.The dwStatus member of the DBPROP Structure indicates DBPROPSTATUS_NOTSUPPORTED.
DBPROP_INIT_PROMPTDBPROP_INIT_PROMPT El proveedor OLE DB de SQL ServerSQL Server Native Client admite todos los modos de solicitud de inicialización del origen de datos.The SQL ServerSQL Server Native Client OLE DB provider supports all prompting modes for data source initialization. El proveedor OLE DB de SQL ServerSQL Server Native Client usa DBPROMPT_NOPROMPT como valor predeterminado para la propiedad.The SQL ServerSQL Server Native Client OLE DB provider uses DBPROMPT_NOPROMPT as its default setting for the property.
DBPROP_INIT_PROTECTION_LEVELDBPROP_INIT_PROTECTION_LEVEL El proveedor OLE DB de SQL ServerSQL Server Native Client no admite un nivel de protección en las conexiones a instancias de SQL ServerSQL Server.The SQL ServerSQL Server Native Client OLE DB provider does not support a protection level on connections to instances of SQL ServerSQL Server.

El proveedor OLE DB de SQL ServerSQL Server Native Client devuelve DB_S_ERRORSOCCURRED en un intento por establecer el valor de propiedad.The SQL ServerSQL Server Native Client OLE DB provider returns DB_S_ERRORSOCCURRED on an attempt to set the property value. El miembro dwStatus de la estructura DBPROP indica DBPROPSTATUS_NOTSUPPORTED.The dwStatus member of the DBPROP Structure indicates DBPROPSTATUS_NOTSUPPORTED.
DBPROP_INIT_PROVIDERSTRINGDBPROP_INIT_PROVIDERSTRING Vea la cadena del proveedor OLE DB de SQL ServerSQL Server Native Client más adelante en este tema.See the SQL ServerSQL Server Native Client OLE DB provider string later in this topic.
DBPROP_INIT_TIMEOUTDBPROP_INIT_TIMEOUT El proveedor OLE DB de SQL ServerSQL Server Native Client devuelve un error de inicialización si no puede establecerse una conexión con la instancia de SQL ServerSQL Server tras el número de segundos especificado.The SQL ServerSQL Server Native Client OLE DB provider returns an error on initialization if a connection to the instance of SQL ServerSQL Server cannot be established within the number of seconds specified.

En la propiedad específica del proveedor establezca DBPROPSET_SQLSERVERDBINIT, el SQL ServerSQL Server proveedor OLE DB de Native Client define estas propiedades de inicialización adicionales.In the provider-specific property set DBPROPSET_SQLSERVERDBINIT, the SQL ServerSQL Server Native Client OLE DB provider defines these additional initialization properties.

Id. de propiedadProperty ID DescripciónDescription
SSPROP_AUTH_OLD_PASSWORDSSPROP_AUTH_OLD_PASSWORD Tipo: VT_BSTRType: VT_BSTR

R/W: EscribirR/W: Write

Predeterminado: VT_EMPTYDefault: VT_EMPTY

Descripción: La contraseña actual o ha expirado.Description: The current or expired password. Para obtener más información, consulte cambiar las contraseñas mediante programación.For more information, see Changing Passwords Programmatically.
SSPROP_INIT_APPNAMESSPROP_INIT_APPNAME Tipo: VT_BSTRType: VT_BSTR

R/W: lectura/escrituraR/W: Read/write

Descripción: El nombre de la aplicación cliente.Description: The client application name.
SSPROP_INIT_AUTOTRANSLATESSPROP_INIT_AUTOTRANSLATE Tipo: VT_BOOLType: VT_BOOL

R/W: lectura/escrituraR/W: Read/write

Predeterminado: VARIANT_TRUEDefault: VARIANT_TRUE

Descripción: Conversión de caracteres OEM/ANSI.Description: OEM/ANSI character conversion.

VARIANT_TRUE: El SQL ServerSQL Server proveedor OLE DB de 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 en el cliente y el servidor:VARIANT_TRUE: The SQL ServerSQL Server Native Client OLE DB provider translates ANSI character strings sent between the client and server by converting through Unicode to minimize problems in matching extended characters between the code pages on the client and the server:

Los datos DBTYPE_STR del cliente enviados a una instancia de la variable, parámetro o columna char, varchar o text de SQL ServerSQL 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.Client DBTYPE_STR data sent to an instance of SQL ServerSQL Serverchar, varchar, or text variable, parameter, or column is converted from character to Unicode using the client ANSI code page (ACP) and then converted from Unicode to character using the ACP of the server.

Los datos char, varchar o text de SQL ServerSQL 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.SQL ServerSQL Server char, varchar, or text data sent to a client DBTYPE_STR variable is converted from character to Unicode using the server ACP and then converted from Unicode to character using the client ACP.

El proveedor OLE DB de SQL ServerSQL Server Native Client realiza estas conversiones en el cliente.These conversions are performed on the client by the SQL ServerSQL Server Native Client OLE DB provider. Esto requiere que la misma ACP que se usa en el servidor esté disponible en el cliente.This requires that the same ACP used on the server be available on the client.

Esta configuración no tiene ningún efecto en las conversiones que se realizan para estas transferencias:These settings have no effect on the conversions that occur for these transfers:

Los datos de cliente DBTYPE_WSTR de Unicode enviados a char, varchar o text en el servidor.Unicode DBTYPE_WSTR client data sent to char, varchar, or text on the server.

Los datos de servidor char, varchar o text enviados a una variable DBTYPE_WSTR de Unicode en el cliente.char, varchar, or text server data sent to a Unicode DBTYPE_WSTR variable on the client.

Los datos de cliente DBTYPE_STR de ANSI enviados a nchar, nvarchar o ntext de Unicode en el servidor.ANSI DBTYPE_STR client data sent to Unicode nchar, nvarchar, or ntext on the server.

Los datos de servidor char, varchar o text de Unicode enviados a una variable DBTYPE_STR de ANSI en el cliente.Unicode char, varchar, or text server data sent to an ANSI DBTYPE_STR variable on the client.

VARIANT_FALSE: El SQL ServerSQL Server proveedor OLE DB de Native Client no realiza traducciones de caracteres.VARIANT_FALSE: The SQL ServerSQL Server Native Client OLE DB provider does not perform character translations.

El SQL ServerSQL Server proveedor OLE DB de Native Client no traduce los datos DBTYPE_STR de caracteres cliente ANSI enviados a char, varchar, o texto variables, parámetros o columnas en el servidor.The SQL ServerSQL Server Native Client OLE DB provider does not translate client ANSI character DBTYPE_STR data sent to char, varchar, or text variables, parameters, or columns on the server. No se realiza ninguna traducción en los datos char, varchar o text enviados del servidor a las variables DBTYPE_STR en el cliente.No translation is performed on char, varchar, or text data sent from the server to DBTYPE_STR variables on the client.

Si el cliente y la instancia de SQL ServerSQL Server están utilizando distintas ACP, pueden malinterpretarse los caracteres extendidos.If the client and the instance of SQL ServerSQL Server are using different ACPs, extended characters can be misinterpreted.
SSPROP_INIT_CURRENTLANGUAGESSPROP_INIT_CURRENTLANGUAGE Tipo: VT_BSTRType: VT_BSTR

R/W: lectura/escrituraR/W: Read/write

Descripción: Un SQL ServerSQL Server nombre del idioma.Description: A SQL ServerSQL Server language name. Identifica el lenguaje que se usa para la selección y el formato de mensajes del sistema.Identifies the language used for system message selection and formatting. El lenguaje debe instalarse en el equipo que ejecuta una instancia de SQL ServerSQL Server o, de lo contrario, se producirá un error de inicialización del origen de datos.The language must be installed on the computer running an instance of SQL ServerSQL Server or data source initialization fails.
SSPROP_INIT_DATATYPECOMPATIBILITYSSPROP_INIT_DATATYPECOMPATIBILITY Tipo: VT_UI2Type: VT_UI2

R/W: lectura/escrituraR/W: Read/write

Predeterminado: 0Default: 0

Descripción: Permite la compatibilidad de tipo de datos entre SQL ServerSQL Server y aplicaciones de objeto de datos ActiveX (ADO).Description: Enables data type compatibility between SQL ServerSQL Server and ActiveX Data Object (ADO) applications. Si se utiliza el valor predeterminado 0, la administración de tipos de datos usa el valor predeterminado del proveedor.If the default value of 0 is used, data type handling defaults to that used by the provider. Si se usa el valor 80, la administración de tipos de datos solo usa tipos de datos de SQL Server 2000 (8.x)SQL Server 2000 (8.x).If the value of 80 is used, data type handling uses only SQL Server 2000 (8.x)SQL Server 2000 (8.x) data types. Para obtener más información, consulte utilizar ADO con SQL Server Native Client.For more information, see Using ADO with SQL Server Native Client.
SSPROP_INIT_ENCRYPTSSPROP_INIT_ENCRYPT Tipo: VT_BOOLType: VT_BOOL

R/W: Lectura/escrituraR/W: Read/Write

Predeterminado: VARIANT_FALSEDefault: VARIANT_FALSE

Descripción: Para cifrar los datos a través de la red, la propiedad SSPROP_INIT_ENCRYPT se establece en VARIANT_TRUE.Description: To encrypt the data going over the network, SSPROP_INIT_ENCRYPT property is set to VARIANT_TRUE.

Si el cifrado de protocolo está habilitado, siempre se llevará a cabo el cifrado, independientemente del valor de SSPROP_INIT_ENCRYPT.If Enable Protocol Encryption is on, encryption will always occur, regardless of the setting of SSPROP_INIT_ENCRYPT. Si no está habilitado y la propiedad SSPROP_INIT_ENCRYPT está establecida en VARIANT_TRUE, se llevará a cabo el cifrado.If it is off and SSPROP_INIT_ENCRYPT is set to VARIANT_TRUE, then encryption will occur.

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.If Enable Protocol Encryption is off and SSPROP_INIT_ENCRYPT is set to VARIANT_FALSE, then no encryption occurs.
SSPROP_INIT_FAILOVERPARTNERSSPROP_INIT_FAILOVERPARTNER Tipo: VT_BSTRType: VT_BSTR

R/W: lectura/escrituraR/W: Read/write

Descripción: Especifica el nombre del asociado de conmutación por error de creación de reflejo de base de datos.Description: Specifies the name of the failover partner for database mirroring. Se trata de una propiedad de inicialización y solo puede establecerse antes de la inicialización.It is an initialization property and can only be set before initialization. Tras la inicialización, devolverá el asociado de conmutación por error devuelto por el servidor principal, si existe.After initialization it will return the failover partner, if any, returned by the primary server.

Esto permite que una aplicación inteligente almacene en memoria caché el servidor de copia de seguridad determinado más recientemente, pero dichas aplicaciones necesitan 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.This allows a smart application to cache the most recently determined backup server, but such applications should be aware that the information is only updated when the connection is first established (or reset, if pooled) and can become out of date for long term connections.

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.After making the connection, the application can query this attribute to determine the identity of the failover partner. Si el servidor principal no tiene ningún asociado de conmutación por error, esta propiedad devolverá una cadena vacía.If the primary server has no failover partner this property will return an empty string. Para obtener más información, vea Usar la creación de reflejo de la base de datos.For more information, see Using Database Mirroring.
SSPROP_INIT_FILENAMESSPROP_INIT_FILENAME Tipo: VT_BSTRType: VT_BSTR

R/W: lectura/escrituraR/W: Read/write

Descripción: Especifica el nombre del archivo principal de una base de datos adjuntable.Description: Specifies the primary file name of an attachable database. Esta base de datos se adjunta y se convierte en la base de datos predeterminada para la conexión.This database is attached and becomes the default database for the connection. 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.To use SSPROP_INIT_FILENAME, you must specify the name of the database as the value of the initialization property 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.If the database name does not exist, then it looks for the primary file name specified in SSPROP_INIT_FILENAME and attaches that database with the name specified in DBPROP_INIT_CATALOG. Si la base de datos se ha adjuntado previamente, SQL ServerSQL Server no vuelve a adjuntarla.If the database was previously attached, SQL ServerSQL Server does not reattach it.
SSPROP_INIT_MARSCONNECTIONSSPROP_INIT_MARSCONNECTION Tipo: VT_BOOLType: VT_BOOL

R/W: lectura/escrituraR/W: Read/write

Predeterminado: VARIANT_FALSEDefault: VARIANT_FALSE

Descripción: Especifica si se ha habilitado Multiple Active Result Sets (MARS) para la conexión.Description: Specifies if Multiple Active Result Sets (MARS) are enabled for the connection. Esta opción debe establecerse en True antes de realizar cualquier conexión a la base de datos.This option must be set to true before a connection is made to the database. Para obtener más información, vea Usar conjuntos de resultados activos múltiples (MARS).For more information, see Using Multiple Active Result Sets (MARS).
SSPROP_INIT_NETWORKADDRESSSSPROP_INIT_NETWORKADDRESS Tipo: VT_BSTRType: VT_BSTR

R/W: lectura/escrituraR/W: Read/write

Descripción: La dirección de red del servidor que ejecuta una instancia de SQL ServerSQL Server especificado por la propiedad DBPROP_INIT_DATASOURCE.Description: The network address of the server running an instance of SQL ServerSQL Server specified by the DBPROP_INIT_DATASOURCE property.
SSPROP_INIT_NETWORKLIBRARYSSPROP_INIT_NETWORKLIBRARY Tipo: VT_BSTRType: VT_BSTR

R/W: lectura/escrituraR/W: Read/write

Descripción: El nombre de la biblioteca de red (DLL) utilizado para comunicarse con una instancia de SQL ServerSQL Server.Description: The name of the networklibrary (DLL) used to communicate with an instance of SQL ServerSQL Server. El nombre no debe incluir la ruta de acceso ni la extensión de nombre de archivo .dll.The name should not include the path or the .dll file name extension.

El valor predeterminado puede personalizarse mediante la utilidad de configuración del cliente de SQL ServerSQL Server.The default can be customized using the SQL ServerSQL Server Client Configuration Utility.

Nota: Sólo TCP y canalizaciones con nombre son compatibles con esta propiedad.Note: Only TCP and Named Pipes are supported by this property. Si usa esta propiedad con un prefijo, terminará con un prefijo doble que generará un error, puesto que la propiedad se utiliza para generar un prefijo internamente.If you use this property with a prefix, you end up with a double prefix which results in an error, because the property is used to generate a prefix internally.
SSPROP_INIT_PACKETSIZESSPROP_INIT_PACKETSIZE Tipo: VT_I4Type: VT_I4

R/W: lectura/escrituraR/W: Read/write

Descripción: Un tamaño de paquete de red en bytes.Description: A network packet size in bytes. El valor de la propiedad de tamaño de paquete debe estar comprendido entre 512 y 32.767.The packet size property value must be between 512 and 32,767. El tamaño predeterminado de los paquetes de red del proveedor OLE DB de SQL ServerSQL Server Native Client es 4.096.The default SQL ServerSQL Server Native Client OLE DB provider network packet size is 4,096.
SSPROP_INIT_TAGCOLUMNCOLLATIONSSPROP_INIT_TAGCOLUMNCOLLATION Tipo: BOOLType: BOOL

R/W: EscribirR/W: Write

Predeterminado: FALSEDefault: FALSE

Descripción: Se usa durante una actualización de la base de datos cuando se utilizan cursores de servidor.Description: Is used during a database update when server-side cursors are used. 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.This property tags the data with collation information obtained from the server instead of the code page on the client. Actualmente, solo utiliza esta propiedad el proceso de consulta distribuida, puesto que conoce la intercalación de datos del destino y la convierte correctamente.Currently, this property is used only by the distributed query process because it knows the collation of destination data and converts it correctly.
SSPROP_INIT_TRUST_SERVER_CERTIFICATESSPROP_INIT_TRUST_SERVER_CERTIFICATE Tipo: VT_BOOLType: VT_BOOL

R/W: lectura/escrituraR/W: Read/write

Predeterminado: VARIANT_FALSEDefault: VARIANT_FALSE

Descripción: Se utiliza para habilitar o deshabilitar la validación de certificados de servidor.Description: Used to enable or disable server certificate validation. Esta propiedad es de lectura/escritura, pero cualquier intento por establecerla una vez que se haya establecido una conexión generará un error.This property is read/write, but attempting to set it after a connection has been established will result in an error.

Esta propiedad se omite si el cliente se configura de modo que requiere validación de certificados.This property is ignored if the client is configured to require certificate validation. 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.However, an application can use it together with SSPROP_INIT_ENCRYPT to guarantee that its connection to the server is encrypted, even if the client is configured not to require encryption and no certificate is provisioned on the client.

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.Client applications can query this property after a connection has been opened to determine the actual encryption and validation settings in use.

Nota: Utilizar el cifrado sin validación de certificados ofrece una protección parcial contra el rastreo de paquetes, pero no protege frente a ataques man-in-the-middle.Note: Using encryption without certificate validation provides partial protection against packet sniffing, but it does not protect against man-in-the-middle attacks. Simplemente permite cifrar el inicio de sesión y los datos enviados al servidor sin validar el certificado de servidor.It simply allows for encrypting the login and data sent to the server without validating the server certificate.

Para obtener más información, vea Usar el cifrado sin validación.For more information, see Using Encryption Without Validation.
SSPROP_INIT_USEPROCFORPREPSSPROP_INIT_USEPROCFORPREP Tipo: VT_I4Type: VT_I4

R/W: lectura/escrituraR/W: Read/write

Predeterminado: SSPROPVAL_USEPROCFORPREP_ONDefault: SSPROPVAL_USEPROCFORPREP_ON

Descripción: El SQL ServerSQL Server uso de procedimientos almacenados.Description: The SQL ServerSQL Server stored procedure use. Define el uso de procedimientos almacenados de forma temporal de SQL ServerSQL Server para admitir la interfaz ICommandPrepare.Defines the use of SQL ServerSQL Server temporary stored procedures to support the ICommandPrepare interface. Esta propiedad solo era significativa al establecer una conexión a SQL Server 6.5.This property was meaningful only when connecting to SQL Server 6.5. se omite en versiones posteriores.The property is ignored for later versions.

SSPROPVAL_USEPROCFORPREP_OFF: No se crea un procedimiento almacenado temporal cuando se prepara un comando.SSPROPVAL_USEPROCFORPREP_OFF: A temporary stored procedure is not created when a command is prepared.

SSPROPVAL_USEPROCFORPREP_ON: Se crea un procedimiento almacenado temporal cuando se prepara un comando.SSPROPVAL_USEPROCFORPREP_ON: A temporary stored procedure is created when a command is prepared. Cuando se libera la sesión, se quitan los procedimientos almacenados temporales.The temporary stored procedures are dropped when the session is released.

SSPROPVAL_USEPROCFORPREP_ON_DROP: Se crea un procedimiento almacenado temporal cuando se prepara un comando.SSPROPVAL_USEPROCFORPREP_ON_DROP: A temporary stored procedure is created when a command is prepared. El procedimiento se descarta 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.The procedure is dropped when the command is unprepared with ICommandPrepare::Unprepare, when a new command is specified for the command object with ICommandText::SetCommandText, or when all application references to the command are released.
SSPROP_INIT_WSIDSSPROP_INIT_WSID Tipo: VT_BSTRType: VT_BSTR

R/W: lectura/escrituraR/W: Read/write

Descripción: Cadena que identifica la estación de trabajo.Description: A string identifying the workstation.

En la propiedad específica del proveedor establezca dbpropset_sqlserverdatasource, el SQL ServerSQL Server proveedor OLE DB de Native Client define las propiedades adicionales; vea propiedades de información de origen de datos para obtener más información.In the provider-specific property set DBPROPSET_SQLSERVERDATASOURCEINFO, the SQL ServerSQL Server Native Client OLE DB provider defines the additional properties; see Data Source Information Properties for more information.

Cadena del proveedor OLE DB de SQL Server Native ClientThe SQL Server Native Client OLE DB Provider String

El proveedor OLE DB de SQL ServerSQL Server Native Client reconoce una sintaxis similar a la de ODBC en los valores de propiedad de cadena del proveedor.The SQL ServerSQL Server Native Client OLE DB provider recognizes an ODBC-like syntax in provider string property values. 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.The provider string property is provided as the value of the OLE DB initialization property DBPROP_INIT_PROVIDERSTRING when a connection is established to the OLE DB data source. 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.This property specifies OLE DB provider-specific connection data required to implement a connection to the OLE DB data source. Dentro de la cadena, los elementos están delimitados mediante un punto y coma.Within the string, elements are delimited by using a semicolon. El último elemento de la cadena debe terminar con un punto y coma.The final element in the string must be terminated with a semicolon. Cada elemento consta de una palabra clave, un carácter de signo igual y el valor que se pasó en la inicialización.Each element consists of a keyword, an equal sign character, and the value passed on initialization. Por ejemplo:For example:

Server=MyServer;UID=MyUserName;  

Con el proveedor OLE DB de SQL ServerSQL Server Native Client, el consumidor no necesita usar nunca la propiedad de cadena del proveedor.With the SQL ServerSQL Server Native Client OLE DB provider, the consumer never needs to use the provider string property. 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 ServerSQL Server Native Client o de OLE DB.The consumer can set any initialization property reflected in the provider string by using either OLE DB or SQL ServerSQL Server Native Client OLE DB provider-specific initialization properties.

Para obtener una lista de las palabras clave disponibles en el SQL ServerSQL Server proveedor Native Client OLE DB, consulte Using Connection String Keywords with SQL Server Native Client.For a list of the keywords available in the SQL ServerSQL Server Native Client OLE DB provider, see Using Connection String Keywords with SQL Server Native Client.

Vea tambiénSee Also

Objetos de origen de datos (OLE DB)Data Source Objects (OLE DB)