Compartir por


Propiedades y comportamientos de conjuntos de filas

Se aplica a: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Descargar controlador OLE DB

Estas son las propiedades de los conjuntos de filas de OLE DB Driver for SQL Server:

Id. de propiedad Descripción
DBPROP_ABORTPRESERVE R (lectura) y W (escritura): Lectura/escritura

Valor predeterminado: VARIANT_FALSE

Descripción: esta propiedad determina el comportamiento de un conjunto de filas tras una operación de anulación.

VARIANT_FALSE: OLE DB Driver for SQL Server invalida los conjuntos de filas después de una operación de anulación. Prácticamente se pierde la funcionalidad del objeto de conjunto de filas. Solo se admiten operaciones IUnknown y la liberación de identificadores de descriptores de acceso y filas pendientes.

VARIANT_TRUE: OLE DB Driver for SQL Server mantiene un conjunto de filas válido.
DBPROP_ACCESSORDER R (lectura) y W (escritura): Lectura/escritura

Valor predeterminado: DBPROPVAL_AO_RANDOM

Descripción: orden de acceso. orden en que debe obtenerse acceso a las columnas en el conjunto de filas.

DBPROPVAL_AO_RANDOM: se puede acceder a la columna en cualquier orden.

DBPROPVAL_AO_SEQUENTIALSTORAGEOBJECTS: solamente se puede acceder a columnas enlazadas como objetos de almacenamiento en orden secuencial, según determina el índice de columna.

DBPROPVAL_AO_SEQUENTIAL: se debe acceder a todas las columnas en orden secuencial, según determina el índice de columna.
DBPROP_APPENDONLY OLE DB Driver for SQL Server no implementa esta propiedad de conjunto de filas. Al intentar leer o escribir el valor de propiedad, se genera un error.
DBPROP_BLOCKINGSTORAGEOBJECTS R (lectura) y W (escritura): Solo lectura

Valor predeterminado: VARIANT_TRUE

Descripción: Los objetos de almacenamiento de OLE DB Driver for SQL Server se bloquean mediante otros métodos de conjunto de filas.
DBPROP_BOOKMARKS DBPROP_LITERALBOOKMARKS R (lectura) y W (escritura): Lectura/escritura

Valor predeterminado: VARIANT_FALSE

Descripción: OLE DB Driver for SQL Server admite marcadores para la identificación de filas del conjunto de filas cuando DBPROP_BOOKMARKS o DBPROP_LITERALBOOKMARKS es VARIANT_TRUE.

Al establecer una de estas propiedades en VARIANT_TRUE no se habilita el posicionamiento por marcador del conjunto de filas. Establezca DBPROP_IRowsetLocate o DBPROP_IRowsetScroll en VARIANT_TRUE para crear un conjunto de filas que admita el posicionamiento por marcador del conjunto de filas.

OLE DB Driver for SQL Server usa un cursor Microsoft SQL Server para admitir un conjunto de filas que contiene marcadores. Para obtener más información, vea Conjuntos de filas y cursores de SQL Server.

Nota: Si estas propiedades entran en conflicto con otras propiedades de definición de cursor del controlador OLE DB para SQL Server, se producirá un error. Por ejemplo, si DBPROP_BOOKMARKS se establece en VARIANT_TRUE cuando la propiedad DBPROP_OTHERINSERT también está establecida en VARIANT_TRUE, se genera un error cuando el consumidor intenta abrir un conjunto de filas.
DBPROP_BOOKMARKSKIPPED R (lectura) y W (escritura): Solo lectura

Valor predeterminado: VARIANT_FALSE

Descripción: OLE DB Driver for SQL Server devuelve DB_E_BADBOOKMARK si el consumidor indica un marcador no válido al colocar o buscar un conjunto de filas marcado.
DBPROP_BOOKMARKTYPE R (lectura) y W (escritura): Solo lectura

Valor predeterminado: DBPROPVAL_BMK_NUMERIC

Descripción: OLE DB Driver for SQL Server solo implementa marcadores numéricos. Un marcador de OLE DB Driver for SQL Server es un entero sin signo de 32 bits, de tipo DBTYPE_UI4.
DBPROP_CACHEDEFERRED OLE DB Driver for SQL Server no implementa esta propiedad de conjunto de filas. Al intentar leer o escribir el valor de propiedad, se genera un error.
DBPROP_CANFETCHBACKWARDS DBPROP_CANSCROLLBACKWARDS R (lectura) y W (escritura): Lectura/escritura

Valor predeterminado: VARIANT_FALSE

Descripción: OLE DB Driver for SQL Server admite la captura y el desplazamiento hacia atrás en conjuntos de filas no secuenciales. El controlador OLE DB para SQL Server crea un conjunto de filas que admite cursores cuando DBPROP_CANFETCHBACKWARDS o DBPROP_CANSCROLLBACKWARDS es VARIANT_TRUE. Para obtener más información, vea Conjuntos de filas y cursores de SQL Server.
DBPROP_CANHOLDROWS R (lectura) y W (escritura): Lectura/escritura

Valor predeterminado: VARIANT_FALSE

Descripción: de forma predeterminada, OLE DB Driver for SQL Server devuelve DB_E_ROWSNOTRELEASED si el consumidor intenta obtener más filas de un conjunto de filas mientras hay cambios pendientes en las que están actualmente en el conjunto de filas. Este comportamiento puede modificarse.

El establecimiento de DBPROP_CANHOLDROWS y DBPROP_IRowsetChange en VARIANT_TRUE, implica un conjunto de filas marcado. Si ambas propiedades son VARIANT_TRUE, la interfaz IRowsetLocate estará disponible en el conjunto de filas y las propiedades DBPROP_BOOKMARKS y DBPROP_LITERALBOOKMARKS serán ambas VARIANT_TRUE.

Los cursores de SQL Server admiten conjuntos de filas de OLE DB Driver for SQL Server que contienen marcadores.
DBPROP_CHANGEINSERTEDROWS R (lectura) y W (escritura): Lectura/escritura

Valor predeterminado: VARIANT_FALSE

Descripción: esta propiedad solo puede establecerse en VARIANT_TRUE si el conjunto de filas usa un cursor controlado por conjunto de claves.
DBPROP_COLUMNRESTRICT R (lectura) y W (escritura): Solo lectura

Valor predeterminado: VARIANT_FALSE

Descripción: OLE DB Driver for SQL Server establece la propiedad en VARIANT_TRUE cuando el consumidor no puede modificar una columna de un conjunto de filas. Es posible que otras columnas del conjunto de filas puedan actualizarse y también es posible que puedan eliminarse las propias filas.

Cuando esta propiedad es VARIANT_TRUE, el consumidor examina el miembro dwFlags de la estructura DBCOLUMNINFO para determinar si puede escribirse o no el valor de una columna individual. Para las columnas que pueden modificarse, dwFlags muestra DBCOLUMNFLAGS_WRITE.
DBPROP_COMMANDTIMEOUT R (lectura) y W (escritura): Lectura/escritura

Valor predeterminado: 0

Descripción: De forma predeterminada, OLE DB Driver for SQL Server no agota el tiempo de espera en el método ICommand::Execute.
DBPROP_COMMITPRESERVE R (lectura) y W (escritura): Lectura/escritura

Valor predeterminado: VARIANT_FALSE

Descripción: esta propiedad determina el comportamiento de un conjunto de filas tras una operación de confirmación.

VARIANT_TRUE: OLE DB Driver for SQL Server mantiene un conjunto de filas válido.

VARIANT_FALSE: OLE DB Driver for SQL Server invalida los conjuntos de filas después de una operación de confirmación. Prácticamente se pierde la funcionalidad del objeto de conjunto de filas. Solo se admiten operaciones IUnknown y la liberación de identificadores de descriptores de acceso y filas pendientes.
DBPROP_DEFERRED R (lectura) y W (escritura): Lectura/escritura

Valor predeterminado: VARIANT_FALSE

Descripción: cuando se establece en VARIANT_TRUE, OLE DB Driver for SQL Server intenta usar un cursor de servidor para el conjunto de filas. El servidor no devuelve las columnas text, ntext e image hasta que la aplicación acceda a estas.
DBPROP_DELAYSTORAGEOBJECTS R (lectura) y W (escritura): Solo lectura

Valor predeterminado: VARIANT_FALSE

Descripción: OLE DB Driver for SQL Server admite el modo de actualización inmediata en los objetos de almacenamiento.

Los cambios realizados en los datos de un objeto de flujo se envían inmediatamente a SQL Server. Las modificaciones se confirman en función del modo de transacción del conjunto de filas.
DBPROP_HIDDENCOLUMNS R (lectura) y W (escritura): Solo lectura

Valor predeterminado: VARIANT_FALSE

Descripción: Recuento de columnas ocultas

Si DBPROP_UNIQUEROWS es VARIANT_TRUE, la propiedad DBPROP_HIDDENCOLUMNS devuelve el número de columnas "ocultas" adicionales agregadas por el proveedor para identificar de forma única las filas del conjunto de filas. Los métodos IColumnsInfo::GetColumnInfo e IColumnsRowset::GetColumnsRowset devuelven estas columnas. Pero no se incluyen en el número de filas indicado por el argumento pcColumns devuelto por IColumnsInfo::GetColumnInfo.

Para determinar el número total de columnas representadas en la estructura prgInfo devuelta por IColumnsInfo::GetColumnInfo, incluidas las columnas ocultas, el consumidor suma el valor de DBPROP_HIDDENCOLUMNS al número de columnas devuelto por IColumnsInfo::GetColumnInfo en pcColumns. Si DBPROP_UNIQUEROWS es VARIANT_FALSE, DBPROP_HIDDENCOLUMNS es cero.
DBPROP_IAccessor DBPROP_IColumnsInfo DBPROP_IConvertType DBPROP_IRowset DBPROP_IRowsetInfo R (lectura) y W (escritura): Solo lectura

Valor predeterminado: VARIANT_TRUE

Descripción: OLE DB Driver for SQL Server admite estas interfaces en todos los conjuntos de filas.
DBPROP_IColumnsRowset R (lectura) y W (escritura): Lectura/escritura

Valor predeterminado: VARIANT_TRUE

Descripción: OLE DB Driver for SQL Server admite la interfaz IColumnsRowset.
DBPROP_IConnectionPointContainer R (lectura) y W (escritura): Lectura/escritura

Valor predeterminado: VARIANT_FALSE

Descripción: IConnectionPointContainer. Si es VARIANT_TRUE, el conjunto de filas admite la interfaz especificada. Si es VARIANT_FALSE, el conjunto de filas no admite la interfaz especificada. Los proveedores que admiten esta interfaz deben admitir la propiedad asociada a la interfaz con un valor VARIANT_TRUE. Estas propiedades se utilizan principalmente para solicitar interfaces a través de ICommandProperties::SetProperties.
DBPROP_IMultipleResults R (lectura) y W (escritura): Lectura/escritura

Valor predeterminado: VARIANT_FALSE

Descripción: OLE DB Driver for SQL Server admite la interfaz IMultipleResults.
DBPROP_IRowsetChange DBPROP_IRowsetUpdate R (lectura) y W (escritura): Lectura/escritura

Valor predeterminado: VARIANT_FALSE

Descripción: OLE DB Driver for SQL Server admite las interfaces IRowsetChange y IRowsetUpdate.

Los conjuntos de filas creados utilizando DBPROP_IRowsetChange igual a VARIANT_TRUE exhiben los comportamientos de modo de actualización inmediatos.

Cuando DBPROP_IRowsetUpdate es VARIANT_TRUE, DBPROP_IRowsetChange también es VARIANT_TRUE. El conjunto de filas exhibe un comportamiento de modo de actualización retrasada.

OLE DB Driver for SQL Server usa un cursor SQL Server para admitir conjuntos de filas que exponen IRowsetChange o IRowsetUpdate. Para obtener más información, vea Conjuntos de filas y cursores de SQL Server.
DBPROP_IRowsetIdentity R (lectura) y W (escritura): Lectura/escritura

Valor predeterminado: VARIANT_TRUE

Descripción: OLE DB Driver for SQL Server admite la interfaz IRowsetIdentity. Si un conjunto de filas admite esta interfaz, cualquier par de identificadores de fila que represente la misma fila subyacente siempre reflejará los mismos datos y el mismo estado. Los consumidores pueden llamar al método IRowsetIdentity:: IsSameRow para comparar dos manipuladores de fila para ver si hacen referencia a la misma instancia de fila.
DBPROP_IRowsetLocate DBPROP_IRowsetScroll R (lectura) y W (escritura): Lectura/escritura

Valor predeterminado: VARIANT_FALSE

Descripción: OLE DB Driver for SQL Server puede exponer las interfaces IRowsetLocate y IRowsetScroll.

Cuando DBPROP_IRowsetLocate es VARIANT_TRUE, DBPROP_CANFETCHBACKWARDS y DBPROP_CANSCROLLBACKWARDS también son VARIANT_TRUE.

Cuando DBPROP_IRowsetScroll es VARIANT_TRUE, DBPROP_IRowsetLocate también es VARIANT_TRUE y ambas interfaces están disponibles en el conjunto de filas.

Se requieren marcadores para ambas interfaces. El controlador OLE DB para SQL Server establece DBPROP_BOOKMARKS y DBPROP_LITERALBOOKMARKS en VARIANT_TRUE cuando el consumidor solicita una de las interfaces.

OLE DB Driver for SQL Server usa cursores de SQL Server para admitir IRowsetLocate y IRowsetScroll. Para obtener más información, vea Conjuntos de filas y cursores de SQL Server.

Si estas propiedades entran en conflicto con otras propiedades de definición de cursor del controlador OLE DB para SQL Server, se producirá un error. Por ejemplo, si DBPROP_IRowsetScroll se establece en VARIANT_TRUE cuando la propiedad DBPROP_OTHERINSERT también está establecida en VARIANT_TRUE, se genera un error cuando el consumidor intenta abrir un conjunto de filas.
DBPROP_IRowsetResynch R (lectura) y W (escritura): Lectura/escritura

Valor predeterminado: VARIANT_FALSE

Descripción: OLE DB Driver for SQL Server expone la interfaz IRowsetResynch a petición. OLE DB Driver for SQL Server puede exponer la interfaz en cualquier conjunto de filas.
DBPROP_ISupportErrorInfo R (lectura) y W (escritura): Lectura/escritura

Valor predeterminado: VARIANT_TRUE

Descripción: OLE DB Driver for SQL Server expone la interfaz ISupportErrorInfo en conjuntos de filas.
DBPROP_ILockBytes OLE DB Driver for SQL Server no implementa esta interfaz. Al intentar leer o escribir la propiedad, se genera un error.
DBPROP_ISequentialStream R (lectura) y W (escritura): Lectura/escritura

Valor predeterminado: VARIANT_FALSE

Descripción: OLE DB Driver for SQL Server expone la interfaz ISequentialStream para admitir datos largos de longitud variable almacenados en SQL Server.
DBPROP_IStorage OLE DB Driver for SQL Server no implementa esta interfaz. Al intentar leer o escribir la propiedad, se genera un error.
DBPROP_IStream OLE DB Driver for SQL Server no implementa esta interfaz. Al intentar leer o escribir la propiedad, se genera un error.
DBPROP_IMMOBILEROWS R (lectura) y W (escritura): Lectura/escritura

Valor predeterminado: VARIANT_TRUE

Descripción: la propiedad solo es VARIANT_TRUE para los cursores de conjunto de claves de SQL Server; es VARIANT_FALSE en el caso de todos los demás cursores.

VARIANT_TRUE: el conjunto de filas no reordenará las filas insertadas o actualizadas. En el caso de IRowsetChange::InsertRow, las filas aparecerán al final del conjunto de filas. En el caso de IRowsetChange::SetData, si el conjunto de filas no está ordenado, no se modificará la posición de las filas actualizadas. Si el conjunto de filas está ordenado y el método IRowsetChange::SetData modifica una columna que se usa para ordenar el conjunto de filas, la fila no se mueve. Si el conjunto de filas se crea en un conjunto de columnas de clave (normalmente un conjunto de filas para el que DBPROP_OTHERUPDATEDELETE es VARIANT_TRUE pero DBPROP_OTHERINSERT es VARIANT_FALSE), modificar el valor de una columna de clave suele ser equivalente a eliminar la fila actual e insertar una nueva. Por lo tanto, si DBPROP_OWNINSERT es VARIANT_FALSE, es posible que parezca que la fila se mueve o incluso desaparece del conjunto de filas, aunque la propiedad DBPROP_IMMOBILEROWS sea VARIANT_TRUE.

VARIANT_FALSE: si el conjunto de filas está ordenado, las filas insertadas aparecen en el orden correcto del conjunto de filas. Si el conjunto de filas no está ordenado, la fila insertada aparece al final. Si IRowsetChange::SetData modifica una columna que se usa para ordenar el conjunto de filas, la fila se mueve. Si el conjunto de filas no está ordenado, no se modifica la posición de la fila.
DBPROP_LITERALIDENTITY R (lectura) y W (escritura): Solo lectura

Valor predeterminado: VARIANT_TRUE

Descripción: esta propiedad siempre es VARIANT_TRUE.
DBPROP_LOCKMODE R (lectura) y W (escritura): Lectura/escritura

Valor predeterminado: DBPROPVAL_LM_NONE

Descripción: nivel de bloqueo aplicado por el conjunto de filas (DBPROPVAL_LM_NONE, DBPROPVAL_LM_SINGLEROW).

Nota: Cuando se usa el aislamiento de instantáneas en una transacción, si un conjunto de filas se abre mediante un cursor de servidor dinámico o de conjunto de claves y el modo de bloqueo se establece en DBPROPVAL_LM_SINGLEROW, se producirá un error al capturar una fila si otro usuario ha actualizado esta fila desde que se iniciara la transacción. En otros tipos de cursor y modos de bloqueo, si otro usuario ha actualizado la fila desde que se inició la transacción, no se produce ningún error hasta que el usuario intenta actualizar la fila. En ambos casos, el servidor genera estos errores.
DBPROP_MAXOPENROWS R (lectura) y W (escritura): Solo lectura

Valor predeterminado: 0

Descripción: OLE DB Driver for SQL Server no limita el número de filas que pueden estar activas en conjuntos de filas.
DBPROP_MAXPENDINGROWS R (lectura) y W (escritura): Solo lectura

Valor predeterminado: 0

Descripción: OLE DB Driver for SQL Server no limita el número de filas de conjunto de filas con cambios pendientes.
DBPROP_MAXROWS R (lectura) y W (escritura): Lectura/escritura

Valor predeterminado: 0

Descripción: de forma predeterminada, OLE DB Driver for SQL Server no limita el número de filas de un conjunto de filas. Cuando el consumidor establece DBPROP_MAXROWS, el controlador OLE DB para SQL Server usa la instrucción SET ROWCOUNT para limitar el número de filas del conjunto de filas.

SET ROWCOUNT puede producir consecuencias no deseadas en la ejecución de instrucciones SQL Server. Para obtener más información, vea SET ROWCOUNT.
DBPROP_MAYWRITECOLUMN OLE DB Driver for SQL Server no implementa esta propiedad del conjunto de filas. Al intentar leer o escribir el valor de propiedad, se genera un error.
DBPROP_MEMORYUSAGE OLE DB Driver for SQL Server no implementa esta propiedad del conjunto de filas. Al intentar leer o escribir el valor de propiedad, se genera un error.
DBPROP_NOTIFICATIONGRANULARITY OLE DB Driver for SQL Server no implementa esta propiedad del conjunto de filas. Al intentar leer o escribir el valor de propiedad, se genera un error.
DBPROP_NOTIFICATIONPHASES R (lectura) y W (escritura): Solo lectura

Valor predeterminado: DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO | DBPROPVAL_NP_SYNCHAFTER | DBPROPVAL_NP_FAILEDTODO | DBPROPVAL_NP_DIDEVENT

Descripción: OLE DB Driver for SQL Server admite todas las fases de notificación.
DBPROP_NOTIFYCOLUMNSET DBPROP_NOTIFYROWDELETE DBPROP_NOTIFYROWFIRSTCHANGE DBPROP_NOTIFYROWINSERT DBPROP_NOTIFYROWRESYNCH DBPROP_NOTIFYROWSETRELEASE DBPROP_NOTIFYROWSETFETCH-POSITIONCHANGE DBPROP_NOTIFYROWUNDOCHANGE DBPROP_NOTIFYROWUNDODELETE DBPROP_NOTIFYROWUNDOINSERT DBPROP_NOTIFYROWUPDATE R (lectura) y W (escritura): Solo lectura

Valor predeterminado: DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO

Descripción: las fases de notificación de OLE DB Driver for SQL Server pueden cancelarse antes de intentar realizar la modificación indicada en el conjunto de filas. OLE DB Driver for SQL Server no admite la cancelación de fases una vez completado el intento.
DBPROP_ORDEREDBOOKMARKS OLE DB Driver for SQL Server no implementa esta propiedad del conjunto de filas. Al intentar leer o escribir el valor de propiedad, se genera un error.
DBPROP_OTHERINSERT DBPROP_OTHERUPDATEDELETE DBPROP_OWNINSERT DBPROP_OWNUPDATEDELETE R (lectura) y W (escritura): Lectura/escritura

Valor predeterminado: VARIANT_FALSE

Descripción: el establecimiento de propiedades de visibilidad de cambios hace que OLE DB Driver for SQL Server use los cursores de SQL Server para admitir el conjunto de filas. Para obtener más información, vea Conjuntos de filas y cursores de SQL Server.
DBPROP_QUICKRESTART R (lectura) y W (escritura): Lectura/escritura

Valor predeterminado: VARIANT_FALSE

Descripción: cuando se establece en VARIANT_TRUE, OLE DB Driver for SQL Server intenta usar un cursor de servidor para el conjunto de filas.
DBPROP_REENTRANTEVENTS R (lectura) y W (escritura): Solo lectura

Valor predeterminado: VARIANT_TRUE

Descripción: los conjuntos de filas de OLE DB Driver for SQL Server son reentrantes y pueden devolver DB_E_NOTREENTRANT si un consumidor intenta acceder a un método de conjunto de filas no reentrante desde una devolución de llamada de notificación.
DBPROP_REMOVEDELETED R (lectura) y W (escritura): Lectura/escritura

Valor predeterminado: VARIANT_FALSE

Descripción: OLE DB Driver for SQL Server altera el valor de la propiedad según la visibilidad de cambios en los datos de SQL Server expuestos por el conjunto de filas.

VARIANT_TRUE: las filas eliminadas por el consumidor u otros usuarios de SQL Server se quitan del conjunto de filas cuando se actualiza este. DBPROP_OTHERINSERT es VARIANT_TRUE.

VARIANT_FALSE: las filas eliminadas por el consumidor u otros usuarios de SQL Server no se quitan del conjunto de filas cuando se actualiza este. El valor de estado de fila para las filas de SQL Server eliminadas del conjunto de filas es DBROWSTATUS_E_DELETED. DBPROP_OTHERINSERT es VARIANT_TRUE.

Esta propiedad solo tiene valor para los conjuntos de filas admitidos por los cursores de SQL Server. Para obtener más información, vea Conjuntos de filas y cursores de SQL Server.

Cuando la propiedad DBPROP_REMOVEDELETED se implementa en un conjunto de filas de cursor de conjunto de claves, las filas eliminadas se quitan en el momento de la captura y es posible que los métodos de captura de filas, como GetNextRows y GetRowsAt, devuelvan S_OK y menos filas de las solicitadas. Tenga en cuenta que este comportamiento no implica la condición DB_S_ENDOFROWSET y que el número de filas devuelto nunca será cero hay filas restantes.
DBPROP_REPORTMULTIPLECHANGES OLE DB Driver for SQL Server no implementa esta propiedad del conjunto de filas. Al intentar leer o escribir el valor de propiedad, se genera un error.
DBPROP_RETURNPENDINGINSERTS R (lectura) y W (escritura): Solo lectura

Valor predeterminado: VARIANT_FALSE

Descripción: cuando se llama a un método que captura filas, OLE DB Driver for SQL Server no devuelve las filas pendientes de inserción.
DBPROP_ROWRESTRICT R (lectura) y W (escritura): Solo lectura

Valor predeterminado: VARIANT_TRUE

Descripción: los conjuntos de filas de OLE DB Driver for SQL Server no admiten derechos de acceso basados en la fila. Si la interfaz IRowsetChange se expone en un conjunto de filas, el consumidor puede llamar al método SetData.
DBPROP_ROWSET_ASYNCH R (lectura) y W (escritura): Lectura/escritura

Valor predeterminado: 0

Descripción: se proporciona para el procesamiento asincrónico del conjunto de filas. Esta propiedad pertenece al grupo de propiedades del conjunto de filas y al conjunto de propiedades DBPROPSET_ROWSET. El tipo es VT_14.

El único valor de la máscara de bits que admite OLE DB Driver for SQL Server es DBPROPVAL_ASYNCH_INITIALIZE.
DBPROP_ROWTHREADMODEL R (lectura) y W (escritura): Solo lectura

Valor predeterminado: DBPROPVAL_RT_FREETHREAD

Descripción: OLE DB Driver for SQL Server admite el acceso a sus objetos desde varios subprocesos de ejecución de un único consumidor.
DBPROP_SERVERCURSOR R (lectura) y W (escritura): Lectura/escritura

Valor predeterminado: VARIANT_FALSE

Descripción: cuando se establece, se usa un cursor de SQL Server para admitir el conjunto de filas. Para obtener más información, vea Conjuntos de filas y cursores de SQL Server.
DBPROP_SERVERDATAONINSERT R (lectura) y W (escritura): Lectura/escritura

Valor predeterminado: VARIANT_FALSE

Descripción: datos de servidor al insertar.

VARIANT_TRUE: en el momento en que se transmite una inserción al servidor, el proveedor recupera los datos del servidor para actualizar la caché de filas local.

VARIANT_FALSE: el proveedor no recupera los valores de servidor para las filas recién insertadas.
DBPROP_STRONGIDENTITY R (lectura) y W (escritura): Solo lectura

Valor predeterminado: VARIANT_TRUE

Descripción: identidad de fila segura. Si se permiten inserciones en un conjunto de filas (IRowsetChange o IRowsetUpdate es true) y DBPROP_UPDATABILITY se establece para admitir InsertRows, el valor de DBPROP_STRONGIDENTITY dependerá de la propiedad DBPROP_CHANGEINSERTEDROWS (será VARIANT_FALSE si el valor de la propiedad DBPROP_CHANGEINSERTEDROWS es VARIANT_FALSE).
DBPROP_TRANSACTEDOBJECT R (lectura) y W (escritura): Solo lectura

Valor predeterminado: VARIANT_FALSE

Descripción: OLE DB Driver for SQL Server solo admite objetos de transacción. Para más información, consulte Transacciones.
DBPROP_UNIQUEROWS R (lectura) y W (escritura): Lectura/escritura

Valor predeterminado: VARIANT_FALSE

Descripción: Filas únicas.

VARIANT_TRUE: cada fila se identifica de forma única mediante sus valores de columna. El conjunto de columnas que identifican de forma única la fila tiene establecido DBCOLUMNFLAGS_KEYCOLUMN en la estructura DBCOLUMNINFO devuelta por el método GetColumnInfo.

VARIANT_FALSE: las filas se pueden identificar o no de forma única por sus valores de columna. Las columnas de clave pueden estar o no estar marcadas con DBCOLUMNFLAGS_KEYCOLUMN.
DBPROP_UPDATABILITY R (lectura) y W (escritura): Lectura/escritura

Valor predeterminado: 0

Descripción: OLE DB Driver for SQL Server admite todos los valores de DBPROP_UPDATABILITY. Al establecer DBPROP_UPDATABILITY, no se crea ningún conjunto de filas que pueda modificarse. Para que un conjunto de filas pueda modificarse, establezca DBPROP_IRowsetChange o DBPROP_IRowsetUpdate.

El controlador OLE DB para SQL Server define el conjunto de propiedades DBPROPSET_SQLSERVERROWSET específico del proveedor, como se muestra en esta tabla.

Id. de propiedad Descripción
SSPROP_COLUMN_ID Columna: ColumnID

R (lectura) y W (escritura): Solo lectura

Tipo: VT_U12 | VT_ARRAY

Valor predeterminado: VT_EMPTY

Descripción: matriz de valores enteros que representan la posición ordinal (en base 1) de una columna de resultados de la cláusula COMPUTE en la instrucción SELECT actual de Transact-SQL. Esta es la API OLE DB Driver for SQL Server equivalente al atributo SQL_CA_SS_COLUMN_ID de ODBC.
SSPROP_DEFERPREPARE Columna: No

R (lectura) y W (escritura): Lectura/escritura

Escriba: VT_BOOL

Valor predeterminado: VARIANT_TRUE

Descripción: VARIANT_TRUE: en una ejecución preparada, la preparación de comandos se aplaza hasta que se llama a ICommand::Execute o hasta que se realiza una operación de metapropiedad. Si la propiedad está establecida en

VARIANT_FALSE: la instrucción se prepara cuando se ejecuta ICommandPrepare::Prepare.
SSPROP_IRowsetFastLoad Columna: No

R (lectura) y W (escritura): Lectura/escritura

Escriba: VT_BOOL

Valor predeterminado: VARIANT_FALSE

Descripción: establezca esta propiedad en VARIANT_TRUE para abrir un conjunto de filas de carga rápida mediante IOpenRowset::OpenRowset. No puede establecer esta propiedad en ICommandProperties::SetProperties.
SSPROP_ISSAsynchStatus Columna: No.

R (lectura) y W (escritura): Lectura/escritura

Escriba: VT_BOOL

Valor predeterminado: VARIANT_FALSE

Descripción: establezca esta propiedad en VARIANT_TRUE para habilitar las operaciones asincrónicas con la interfaz ISSAsynchStatus.
SSPROP_ISSDataClassification R (lectura) y W (escritura): Lectura/escritura

Escriba: VT_BOOL

Valor predeterminado: VARIANT_TRUE

Descripción: El controlador OLE DB Driver for SQL Server admite la recuperación de información de clasificación de confidencialidad mediante la interfaz ISSDataClassification.
SSPROP_MAXBLOBLENGTH Columna: No

R (lectura) y W (escritura): Lectura/escritura

Escriba: VT_I4

Valor predeterminado: el proveedor no restringe el tamaño del texto devuelto por el servidor y el valor de propiedad se establece en su valor máximo. Por ejemplo, 2147483647.

Descripción: OLE DB Driver for SQL Server ejecuta una instrucción SET TEXTSIZE para restringir la longitud de los datos de objetos binarios grandes (BLOB) devueltos por una instrucción SELECT.
SSPROP_NOCOUNT_STATUS Columna: NoCount

R (lectura) y W (escritura): Solo lectura

Escriba: VT_BOOL

Valor predeterminado: VARIANT_FALSE

Descripción: valor booleano que representa el estado de SET NOCOUNT ON/OFF en SQL Server:

VARIANT_TRUE: cuando SET NOCOUNT ON

VARIANT_FALSE: cuando SET NOCOUNT OFF
SSPROP_QP_NOTIFICATION_MSGTEXT Columna: No

R (lectura) y W (escritura): Lectura/escritura

Escriba: VT_BSTR (1-2000 caracteres permitidos)

Valor predeterminado: cadena vacía.

Descripción: texto del mensaje de la notificación de consulta. Lo define el usuario y no tiene ningún formato definido.
SSPROP_QP_NOTIFICATION_OPTIONS Columna: No

R (lectura) y W (escritura): Lectura/escritura

Escriba: VT_BSTR

Valor predeterminado: cadena vacía.

Descripción: Opciones de notificación de consulta. Se especifican en una cadena con name=value. El usuario es responsable de la creación del servicio y de la lectura de las notificaciones fuera de la cola. La sintaxis de la cadena de opciones de notificación de consulta es la siguiente:

service=<service-name>[;(local database=<database>&#124;broker instance=<broker instance>)]

Por ejemplo:

service=mySSBService;local database=mydb
SSPROP_QP_NOTIFICATION_TIMEOUT Columna: No

R (lectura) y W (escritura): Lectura/escritura

Escriba: VT_UI4

Valor predeterminado: 432000 segundos (5 días)

Mínimos: 1 segundo

Máximo: 2^31-1 segundos

Descripción: Número de segundos que la notificación de consulta va a permanecer activa.

Consulte también

Conjuntos de filas