Propiedades de conjuntos de filas (OLE DB)

El conjunto de propiedades DBPROPSET_ROWSET contiene las propiedades siguientes. Todas estas propiedades se encuentran en el grupo de propiedades de conjunto de filas. En DBPROPSET_SSCE_ROWSET se definen propiedades adicionales.

Id. de propiedad	Descripción
DBPROP_ABORTPRESERVE	Tipo: VT_BOOL L/E típica: sólo lectura Descripción: preservar al anular Notas: para este proveedor, el valor es siempre VARIANT_FALSE. Esto indica que, después de anular una transacción, las únicas operaciones que se permite efectuar en un conjunto de filas es liberar los identificadores de fila y de descriptor de acceso y liberar el conjunto de filas.
DBPROP_ACCESSORDER	Tipo: VT_I4 L/E: sólo lectura Descripción: orden de acceso Notas: para este proveedor, el valor es siempre DBPROPVAL_AO_RANDOM.
DBPROP_BLOCKINGSTORAGEOBJECTS	Tipo: VT_BOOL L/E típica: sólo lectura Descripción: bloquear objetos de almacenamiento Notas: para este proveedor, el valor es siempre VARIANT_TRUE.
DBPROP_BOOKMARKS	Tipo: VT_BOOL L/E típica: L/E Descripción: usar marcadores Notas: especifica si el conjunto de filas admite marcadores. El proveedor admite los valores siguientes: VARIANT_TRUE, que indica que el conjunto de filas admite marcadores. La columna 0 es el marcador de las filas. Al tener acceso a esta columna se obtiene un valor de marcador. Dicho valor puede utilizarse para volver a la fila. VARIANT_FALSE, que indica que el conjunto de filas no admite marcadores. El conjunto de filas es secuencial y los valores de las propiedades DBPROP_LITERALBOOKMARKS y DBPROP_ORDEREDBOOKMARKS se pasan por alto.
DBPROP_BOOKMARKTYPE	Tipo: VT_UI4 L/E típica: sólo lectura Descripción: tipo de marcador Notes: especifica el tipo de marcador que admite el conjunto de filas. Para este proveedor, el valor es siempre DBPROPVAL_BMK_NUMERIC. Esto indica que el tipo de marcador es numérico. Los marcadores numéricos se basan en las propiedades de la fila y no dependen de los valores de sus columnas. Por ejemplo, un marcador numérico puede basarse en la posición absoluta de la fila dentro del conjunto de filas o en un id. asignado a una fila por el motor de almacenamiento en el momento de crearla. La modificación de las columnas de una fila no afecta a la validez de los marcadores numéricos. Los marcadores son del tipo DBTYPE_UI4. En las versiones anteriores de SQL Server Compact 3.5, los marcadores eran de tipo DBTYPE_I4.
DBPROP_CANFETCHBACKWARDS	Tipo: VT_BOOL L/E típica: L/E Descripción: recuperar hacia atrás Notas: especifica si se puede recuperar hacia atrás en el conjunto de filas. El proveedor admite los valores siguientes: VARIANT_TRUE, que indica que cRows en IRowset::GetNextRows puede ser negativo. Si lo es, este método recupera filas hacia atrás partiendo de la fila especificada. VARIANT_FALSE, que indica que cRows no puede ser negativo.
DBPROP_CANHOLDROWS	Tipo: VT_BOOL L/E típica: lectura Descripción: conservar filas Notas: para este proveedor, esta propiedad es siempre VARIANT_FALSE.
DBPROP_CANSCROLLBACKWARDS	Tipo: VT_BOOL L/E típica: lectura Descripción: desplazarse hacia atrás Notas: para este proveedor, esta propiedad es siempre VARIANT_FALSE. Esto indica que IRowsOffset no puede ser negativo.
DBPROP_CHANGEINSERTEDROWS	Tipo: VT_BOOL L/E típica: lectura Descripción: cambiar las filas insertadas Notas: para este proveedor, el valor es siempre VARIANT_TRUE. Esto indica que el consumidor puede llamar a IRowsetChange::DeleteRows o a IRowsetChange::SetData para tener acceso a las filas recién insertadas. Una fila recién insertada se define como aquélla cuya inserción se ha transmitido al almacén de datos en lugar de una fila pendiente de insertar.
DBPROP_COMMITPRESERVE	Tipo: VT_BOOL L/E típica: sólo lectura Descripción: preservar al confirmar Notas: para este proveedor, el valor es siempre VARIANT_TRUE. Esto indica que, después de una confirmación que conserva, el conjunto de filas permanece activo. Es decir, se pueden recuperar filas nuevas, actualizar filas, eliminarlas, insertarlas, etcétera.
DBPROP_DEFERRED	Tipo: VT_BOOL L/E típica: sólo lectura Descripción: aplazar columna Notas: para este proveedor, el valor es siempre VARIANT_TRUE. Esto indica que los datos de la columna no se recuperan mientras no se utilice en ella un descriptor de acceso.
DBPROP_DELAYSTORAGEOBJECTS	Tipo: VT_BOOL L/E típica: sólo lectura Descripción: aplazar actualizaciones de objetos de almacenamiento Notas: para este proveedor, el valor es siempre VARIANT_TRUE. Esto indica que los objetos de almacenamiento se utilizan también en modo de actualización aplazada.
DBPROP_IAccessor DBPROP_IColumnsInfo DBPROP_IConvertType DBPROP_IRowset DBPROP_IRowsetChange DBPROP_IRowsetInfo DBPROP_IRowsetUpdate DBPROP_ISupportErrorInfo DBPROP_IRowsetIndex DBPROP_IRowsetCurrentIndex DBPROP_IRowsetBookmark	Tipo: VT_BOOL L/E típica: L/E, excepto en los casos indicados a continuación. Notas: si el valor de cualquiera de estas propiedades se establece en VARIANT_TRUE, el conjunto de filas admitirá la interfaz especificada. Estas propiedades se usan principalmente para solicitar interfaces mediante ICommandProperties::SetProperties. Las propiedades siguientes son de sólo lectura y su valor es siempre VARIANT_TRUE: DBPROP_IAccessor DBPROP_IColumnsInfo DBPROP_IConvertType DBPROP_IRowset DBPROP_IRowsetInfo DBPROP_ISupportErrorInfo Al establecer el valor de DBPROP_IRowsetUpdate en VARIANT_TRUE, DBPROP_IRowsetChange se establece automáticamente en VARIANT_TRUE. Al establecer el valor de DBPROP_IRowsetCurrentIndex en VARIANT_TRUE, DBPROP_IRowsetIndex se establece automáticamente en VARIANT_TRUE.
DBPROP_ILockBytes DBPROP_ISequentialStream	Tipo: VT_BOOL L/E típica: L/E Notas: si el valor de esta propiedad se establece en VARIANT_TRUE, la columna especificada se trata como un objeto de almacenamiento que manifiesta la interfaz especificada.
DBPROP_IMMOBILEROWS	Tipo: VT_BOOL L/E típica: sólo lectura Descripción: filas inmóviles Notas: para este proveedor, el valor es siempre VARIANT_FALSE. Esto indica que, si el conjunto de filas está ordenado, las filas insertadas y actualizadas (en las que se han actualizado una o varias de las columnas que aparecen en los criterios de ordenación) siguen los criterios de ordenación del conjunto de filas. Si el conjunto de filas no está ordenado, no se garantiza que las filas insertadas aparezcan en una posición determinada y la posición de las filas actualizadas no cambia. Esta propiedad sólo es significativa si DBPROP_OWNINSERT es VARIANT_TRUE.
DBPROP_LOCKMODE	Tipo: VT_I4 L/E: lectura Descripción: modo de bloqueo Notas: para este proveedor, el valor es siempre DBPROPVAL_LM_SINGLEROW.
DBPROP_MAXOPENROWS	Tipo: VT_I4 L/E típica: lectura Descripción: número máximo de filas abiertas Notas: este valor es 1 para SQL Server Compact 3.5.
DBPROP_MAXROWS	Tipo: VT_I4 L/E típica: sólo lectura Descripción: número máximo de filas Notas: especifica el número máximo de filas que pueden devolverse en un conjunto de filas. Si no hay límite, el valor es 0. Para este proveedor, el valor es siempre 0.
DBPROP_OTHERINSERT	Tipo: VT_BOOL L/E típica: L/E Descripción: inserción por parte de otros usuarios. Notas: en el caso de las tablas base es True; en el resto de casos es False.
DBPROP_OTHERUPDATEDELETE	Tipo: VT_BOOL L/E típica: L/E Descripción: los cambios de otros usuarios son visibles Notas: especifica uno de los valores siguientes: VARIANT_TRUE, que indica que el conjunto de filas puede ver las actualizaciones y eliminaciones efectuadas por un usuario que no es consumidor del conjunto de filas. Por ejemplo, supongamos que un usuario que no es consumidor del conjunto de filas actualiza los datos subyacentes de una fila o la elimina. Si la fila se libera totalmente, cualquier consumidor del conjunto de filas podrá ver el cambio la próxima vez que recupere esa fila. Aquí se incluyen las actualizaciones y eliminaciones efectuadas por otras partes de la misma transacción, así como las efectuadas por partes externas a la transacción. El nivel de aislamiento de transacción no afecta a la capacidad del conjunto de filas para ver actualizaciones o eliminaciones efectuadas por otras partes de la misma transacción, como otros conjuntos de filas de la misma sesión. No obstante, sí limita la capacidad del conjunto de filas para ver actualizaciones o eliminaciones efectuadas por partes externas a la transacción. VARIANT_FALSE, que indica que el conjunto de filas no puede ver las actualizaciones y eliminaciones efectuadas por otros usuarios.
DBPROP_OWNINSERT	Tipo: VT_BOOL L/E típica: L/E Descripción: propias inserciones visibles
DBPROP_OWNUPDATEDELETE	Tipo: VT_BOOL L/E típica: L/E Descripción: cambios propios visibles
DBPROP_QUICKRESTART	Tipo: VT_BOOL L/E típica: L/E Descripción: reinicio rápido
DBPROP_REMOVEDELETED	Tipo: VT_BOOL L/E típica: lectura Descripción: quitar filas eliminadas Notas: para este proveedor, el valor es siempre VARIANT_TRUE.
DBPROP_REPORTMULTIPLECHANGES	Tipo: VT_BOOL L/E típica: sólo lectura Descripción: informar de varios cambios Notas: para este proveedor, el valor es siempre VARIANT_TRUE.
DBPROP_ROWTHREADMODEL	Tipo: VT_I4 L/E típica: sólo lectura Descripción: modelo de subprocesos de filas. Especifica el modelo de subprocesos de los conjuntos de filas generados por el comando. Para este proveedor, el valor es siempre DBPROPVAL_RT_SINGLETHREAD.
DBPROP_SERVERDATAONINSERT	Tipo: VT_BOOL L/E: lectura Descripción: datos del servidor al insertar Notas: para este proveedor, el valor es siempre VARIANT_TRUE.
DBPROP_UPDATABILITY	Tipo: VT_I4 L/E típica: L/E Descripción: capacidad de actualización