Propiedades y comportamientos del conjuntos de filas (proveedor OLE DB de cliente nativo)
Se aplica a:
SQL Server Azure SQL Database Azure SQL Instancia administrada Azure Synapse Analytics Analytics Platform System (PDW)
Estas son las propiedades del conjunto de filas del proveedor OLE DB de SQL Server Native Client.
| 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: el proveedor OLE DB de SQL Server Native Client 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: el proveedor OLE DB de SQL Server Native Client 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 | El proveedor OLE DB de SQL Server Native Client 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 del proveedor OLE DB de SQL Server Native Client bloquean el uso de otros métodos de conjunto de filas. |
| DBPROP_BOOKMARKS DBPROP_LITERALBOOKMARKS | R (lectura) y W (escritura): Lectura/escritura Valor predeterminado: VARIANT_FALSE Descripción: el proveedor OLE DB de SQL Server Native Client admite marcadores para la identificación de filas del conjunto de filas cuando se DBPROP_BOOKMARKS o DBPROP_LITERALBOOKMARKS se 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. El proveedor OLE DB de SQL Server Native Client usa un cursor de 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: Al establecer estas propiedades en conflicto con otras propiedades de definición de cursor del proveedor OLE DB de SQL Server Native Client, se produce 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: el proveedor OLE DB de SQL Server Native Client 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: el proveedor OLE DB de SQL Server Native Client solo implementa marcadores numéricos. Un marcador de proveedor OLE DB de SQL Server Native Client es entero de 32 bits sin signo, tipo DBTYPE_UI4. |
| DBPROP_CACHEDEFERRED | El proveedor OLE DB de SQL Server Native Client 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: el proveedor OLE DB de SQL Server Native Client admite la captura y el desplazamiento hacia atrás en conjuntos de filas no iniciales. El proveedor OLE DB de SQL Server Native Client crea un conjunto de filas compatible con cursores cuando se VARIANT_TRUE DBPROP_CANFETCHBACKWARDS o DBPROP_CANSCROLLBACKWARDS. 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, el proveedor OLE DB de SQL Server Native Client devuelve DB_E_ROWSNOTRELEASED si el consumidor intenta obtener más filas para un conjunto de filas mientras existen cambios pendientes en los que se encuentran 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 conjuntos de filas del proveedor OLE DB de SQL Server Native Client que contienen marcadores son compatibles con los cursores de SQL Server. |
| 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: el proveedor OLE DB de SQL Server Native Client establece la propiedad en VARIANT_TRUE cuando el consumidor no puede cambiar 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, el proveedor OLE DB de SQL Server Native Client 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: el proveedor OLE DB de SQL Server Native Client mantiene un conjunto de filas válido. VARIANT_FALSE: el proveedor OLE DB de SQL Server Native Client 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 el proveedor OLE DB de SQL Server Native Client 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: el proveedor OLE DB de SQL Server Native Client admite el modo de actualización inmediata en 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: el proveedor OLE DB de SQL Server Native Client admite estas interfaces en todos los conjuntos de filas. |
| DBPROP_IColumnsRowset | R (lectura) y W (escritura): Lectura/escritura Valor predeterminado: VARIANT_TRUE Descripción: el proveedor OLE DB de SQL Server Native Client 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: el proveedor OLE DB de SQL Server Native Client admite la interfaz IMultipleResults . |
| DBPROP_IRowsetChange DBPROP_IRowsetUpdate | R (lectura) y W (escritura): Lectura/escritura Valor predeterminado: VARIANT_FALSE Descripción: el proveedor OLE DB de SQL Server Native Client admite las interfaces IRowsetChange e 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. El proveedor OLE DB de SQL Server Native Client usa un cursor de 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: el proveedor OLE DB de SQL Server Native Client 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: el proveedor OLE DB de SQL Server Native Client puede exponer las interfaces IRowsetLocate e 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 proveedor OLE DB de SQL Server Native Client establece DBPROP_BOOKMARKS y DBPROP_LITERALBOOKMARKS en VARIANT_TRUE cuando el consumidor solicita cualquiera de las interfaces. El proveedor OLE DB de SQL Server Native Client usa cursores de SQL Server para admitir IRowsetLocate e IRowsetScroll. Para obtener más información, vea Conjuntos de filas y cursores de SQL Server. Si se establecen estas propiedades en conflicto con otras propiedades de definición de cursor del proveedor OLE DB de SQL Server Native Client, se produce 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: el proveedor OLE DB de SQL Server Native Client expone la interfaz IRowsetResynch a petición. El proveedor OLE DB de SQL Server Native Client puede exponer la interfaz en cualquier conjunto de filas. |
| DBPROP_ISupportErrorInfo | R (lectura) y W (escritura): Lectura/escritura Valor predeterminado: VARIANT_TRUE Descripción: el proveedor OLE DB de SQL Server Native Client expone la interfaz ISupportErrorInfo en conjuntos de filas. |
| DBPROP_ILockBytes | El proveedor OLE DB de SQL Server Native Client 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: el proveedor OLE DB de SQL Server Native Client expone la interfaz ISequentialStream para admitir datos de longitud variable largos almacenados en SQL Server. |
| DBPROP_IStorage | El proveedor OLE DB de SQL Server Native Client no implementa esta interfaz. Al intentar leer o escribir la propiedad, se genera un error. |
| DBPROP_IStream | El proveedor OLE DB de SQL Server Native Client 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: el proveedor OLE DB de SQL Server Native Client 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: el proveedor OLE DB de SQL Server Native Client no limita el número de filas del conjunto de filas con cambios pendientes. |
| DBPROP_MAXROWS | R (lectura) y W (escritura): Lectura/escritura Valor predeterminado: 0 Descripción: de forma predeterminada, el proveedor OLE DB de SQL Server Native Client no limita el número de filas de un conjunto de filas. Cuando el consumidor establece DBPROP_MAXROWS, el proveedor OLE DB de SQL Server Native Client 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 | El proveedor OLE DB de SQL Server Native Client no implementa esta propiedad de conjunto de filas. Al intentar leer o escribir el valor de propiedad, se genera un error. |
| DBPROP_MEMORYUSAGE | El proveedor OLE DB de SQL Server Native Client no implementa esta propiedad de conjunto de filas. Al intentar leer o escribir el valor de propiedad, se genera un error. |
| DBPROP_NOTIFICATIONGRANULARITY | El proveedor OLE DB de SQL Server Native Client no implementa esta propiedad de 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: el proveedor OLE DB de SQL Server Native Client 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 del proveedor OLE DB de SQL Server Native Client se pueden cancelar antes de intentar realizar la modificación del conjunto de filas indicada. El proveedor OLE DB de SQL Server Native Client no admite la cancelación de fases una vez completado el intento. |
| DBPROP_ORDEREDBOOKMARKS | El proveedor OLE DB de SQL Server Native Client no implementa esta propiedad de 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: establecer las propiedades de visibilidad de cambios hace que el proveedor OLE DB de SQL Server Native Client use 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, el proveedor OLE DB de SQL Server Native Client 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 del proveedor OLE DB de SQL Server Native Client se vuelven a entrar y pueden devolver DB_E_NOTREENTRANT si un consumidor intenta acceder a un método de conjunto de filas que no es de entrada desde una devolución de llamada de notificación. |
| DBPROP_REMOVEDELETED | R (lectura) y W (escritura): Lectura/escritura Valor predeterminado: VARIANT_FALSE Descripción: el proveedor OLE DB de SQL Server Native Client modifica el valor de la propiedad en función de la visibilidad de los 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 | El proveedor OLE DB de SQL Server Native Client no implementa esta propiedad de 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, el proveedor OLE DB de SQL Server Native Client no devuelve filas de inserción pendientes. |
| DBPROP_ROWRESTRICT | R (lectura) y W (escritura): Solo lectura Valor predeterminado: VARIANT_TRUE Descripción: los conjuntos de filas del proveedor OLE DB de SQL Server Native Client no admiten derechos de acceso en función de 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 compatible con SQL Server Native Client es DBPROPVAL_ASYNCH_INITIALIZE. |
| DBPROP_ROWTHREADMODEL | R (lectura) y W (escritura): Solo lectura Valor predeterminado: DBPROPVAL_RT_FREETHREAD Descripción: el proveedor OLE DB de SQL Server Native Client 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: el proveedor OLE DB de SQL Server Native Client solo admite objetos transaccionados. 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: el proveedor OLE DB de SQL Server Native Client 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 proveedor OLE DB de SQL Server Native Client define el conjunto de propiedades específico del proveedor DBPROPSET_SQLSERVERROWSET 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. Este es el proveedor OLE DB de SQL Server Native Client equivalente al atributo ODBC SQL_CA_SS_COLUMN_ID. |
| 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_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: el proveedor OLE DB de SQL Server Native Client ejecuta una instrucción SET TEXTSIZE para restringir la longitud de los datos binarios de objetos grandes (BLOB) devueltos en 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>|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. |