Propiedades y comportamientos de conjuntos de filas
Éstas son las propiedades de los conjuntos de filas del proveedor OLE DB de SQL Server Native Client.
Id. de propiedad |
Descripción |
|---|---|
DBPROP_ABORTPRESERVE |
L/E: 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 |
L/E: 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: puede obtenerse acceso a las columnas en cualquier orden. DBPROPVAL_AO_SEQUENTIALSTORAGEOBJECTS: solamente puede obtenerse acceso a las columnas enlazadas como objetos de almacenamiento en el orden secuencial determinado por el ordinal de columna. DBPROPVAL_AO_SEQUENTIAL: debe obtenerse acceso a todas las columnas en el orden secuencial determinado por el ordinal 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 |
L/E: solo lectura Valor predeterminado: VARIANT_TRUE Descripción: los objetos de almacenamiento del proveedor OLE DB de SQL Server Native Client se bloquean al usar otros métodos de conjunto de filas. |
DBPROP_BOOKMARKS DBPROP_LITERALBOOKMARKS |
L/E: 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 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. 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 servidor de SQL Server. .gif "Nota") Nota
Si estas propiedades se establecen 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 |
L/E: 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 |
L/E: solo lectura Valor predeterminado: DBPROPVAL_BMK_NUMERIC Descripción: el proveedor OLE DB de SQL Server Native Client solamente implementa marcadores numéricos. Un marcador del proveedor OLE DB de SQL Server Native Client es un número 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 |
L/E: 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 secuenciales. El proveedor OLE DB de SQL Server Native Client 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 servidor de SQL Server. |
DBPROP_CANHOLDROWS |
L/E: 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 hay cambios pendientes en las filas actualmente incluidas 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 del proveedor OLE DB de SQL Server Native Client que contienen marcadores. |
DBPROP_CHANGEINSERTEDROWS |
L/E: 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 |
L/E: 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 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 exhibe DBCOLUMNFLAGS_WRITE. |
DBPROP_COMMANDTIMEOUT |
L/E: 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 |
L/E: 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 |
L/E: lectura/escritura Valor predeterminado: VARIANT_FALSE Descripción: cuando se establece en VARIANT_TRUE, el proveedor OLE DB de SQL Server Native Client intenta utilizar un cursor de servidor para el conjunto de filas. El servidor no devuelve las columnas text, ntext e image hasta que la aplicación obtiene acceso a ellas. |
DBPROP_DELAYSTORAGEOBJECTS |
L/E: 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 los objetos de almacenamiento. Los cambios realizados en los datos de un objeto de secuencia 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 |
L/E: 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. Sin embargo, no se incluyen en el recuento de filas devuelto 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 recuento 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 |
L/E: 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 |
L/E: lectura/escritura Valor predeterminado: VARIANT_TRUE Descripción: el proveedor OLE DB de SQL Server Native Client admite la interfaz IColumnsRowset. |
DBPROP_IConnectionPointContainer |
L/E: 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 |
L/E: 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 |
L/E: 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 estableciendo DBPROP_IRowsetChange en VARIANT_TRUE exhiben comportamientos de modo de actualización inmediata. 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 utiliza 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 servidor de SQL Server. |
DBPROP_IRowsetIdentity |
L/E: 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 identificadores de fila y comprobar si hacen referencia a la misma instancia de fila. |
DBPROP_IRowsetLocate DBPROP_IRowsetScroll |
L/E: 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 una de las interfaces. El proveedor OLE DB de SQL Server Native Client usa los cursores de SQL Server para admitir las interfaces IRowsetLocate e IRowsetScroll. Para obtener más información, vea Conjuntos de filas y cursores de servidor de SQL Server. Si estas propiedades se establecen 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 |
L/E: 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 |
L/E: 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 |
L/E: lectura/escritura Valor predeterminado: VARIANT_FALSE Descripción: el proveedor OLE DB de SQL Server Native Client expone la interfaz ISequentialStream para admitir datos largos de longitud variable 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 |
L/E: lectura/escritura Valor predeterminado: VARIANT_TRUE Descripción: la propiedad solo es VARIANT_TRUE para los cursores controlados por conjunto de claves de SQL Server; es VARIANT_FALSE para 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 utiliza 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 utiliza 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 |
L/E: solo lectura Valor predeterminado: VARIANT_TRUE Descripción: esta propiedad siempre es VARIANT_TRUE. |
DBPROP_LOCKMODE |
L/E: 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 utiliza el aislamiento de instantánea en una transacción, si un conjunto de filas se abre mediante un cursor de servidor dinámico o controlado por conjunto de claves y el modo de bloqueo está establecido en DBPROPVAL_LM_SINGLEROW, se producirá un error al capturar una fila si otro usuario ha actualizado esta fila desde que se inició 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 |
L/E: 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 los conjuntos de filas. |
DBPROP_MAXPENDINGROWS |
L/E: 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 |
L/E: 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 |
L/E: 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 |
L/E: 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 pueden cancelarse antes de intentar realizar la modificación indicada en el conjunto de filas. 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 |
L/E: lectura/escritura Valor predeterminado: VARIANT_FALSE Descripción: el establecimiento propiedades de visibilidad de cambios hace que el proveedor OLE DB de SQL Server Native Client utilice los cursores de SQL Server para admitir el conjunto de filas. Para obtener más información, vea Conjuntos de filas y cursores de servidor de SQL Server. |
DBPROP_QUICKRESTART |
L/E: 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 |
L/E: solo lectura Valor predeterminado: VARIANT_TRUE Descripción: los conjuntos de filas del proveedor OLE DB de SQL Server Native Client son reentrantes y pueden devolver DB_E_NOTREENTRANT si un consumidor intenta obtener acceso a un método de conjunto de filas no reentrante desde una devolución de llamada de notificación. |
DBPROP_REMOVEDELETED |
L/E: lectura/escritura Valor predeterminado: VARIANT_FALSE Descripción: el proveedor OLE DB de SQL Server Native Client modifica 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 el conjunto de filas. 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 el conjunto de filas. 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 servidor de SQL Server. Cuando la propiedad DBPROP_REMOVEDELETED se implementa en un conjunto de filas de cursor controlado por 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 |
L/E: 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 las filas pendientes de inserción. |
DBPROP_ROWRESTRICT |
L/E: 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 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 |
L/E: lectura/escritura Valor predeterminado: 0 Descripción: proporciona un 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 SQL Server Native Client es DBPROPVAL_ASYNCH_INITIALIZE. |
DBPROP_ROWTHREADMODEL |
L/E: de 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 |
L/E: lectura/escritura Valor predeterminado: VARIANT_FALSE Descripción: cuando se establece esta propiedad, 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 servidor de SQL Server. |
DBPROP_SERVERDATAONINSERT |
L/E: 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 memoria caché de filas local. VARIANT_FALSE: el proveedor no recupera los valores de servidor para las filas recién insertadas. |
DBPROP_STRONGIDENTITY |
L/E: 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 propiedad DBPROP_CHANGEINSERTEDROWS (será VARIANT_FALSE si el valor de la propiedad DBPROP_CHANGEINSERTEDROWS es VARIANT_FALSE). |
DBPROP_TRANSACTEDOBJECT |
L/E: solo lectura Valor predeterminado: VARIANT_FALSE Descripción: el proveedor OLE DB de SQL Server Native Client solamente admite objetos con transacciones. Para obtener más información, vea Transacciones. |
DBPROP_UNIQUEROWS |
L/E: 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 DBCOLUMNFLAGS_KEYCOLUMN establecido en la estructura DBCOLUMNINFO devuelta por el método GetColumnInfo. VARIANT_FALSE: las filas pueden ser o no ser identificadas de forma única por sus valores de columna. Las columnas de clave pueden estar o no estar marcadas con DBCOLUMNFLAGS_KEYCOLUMN. |
DBPROP_UPDATABILITY |
L/E: 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 DBPROPSET_SQLSERVERROWSET específico de proveedor tal y como se muestra en esta tabla.
Id. de propiedad |
Descripción |
|---|---|
SSPROP_COLUMN_ID |
Columna: ColumnID L/E: 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 de Transact-SQL actual. Éste es el equivalente en el proveedor OLE DB de SQL Server Native Client del atributo SQL_CA_SS_COLUMN_ID de OBDC. |
SSPROP_COMPUTE_BYLIST |
Columna: ComputeByList L/E: solo lectura Tipo: VT_BOOL Valor predeterminado: VARIANT_FALSE Descripción: valor booleano que indica que la columna forma parte del conjunto de resultados COMPUTE BY. Éste es el equivalente en el proveedor OLE DB de SQL Server Native Client del atributo SQL_CA_SS_COMPUTE_BYLIST de OBDC. Nota
La propiedad de OLE DB es un valor booleano, pero el atributo de ODBC es realmente una lista de valores cortos sin signo con toda la parte de ordinales de columna de una cláusula BY.
VARIANT_TRUE: la columna procede de una instrucción COMPUTE BY. VARIANT_FALSE: la columna es una columna normal; no procede de la instrucción COMPUTE BY. |
SSPROP_COMPUTE_ID |
Columna: ComputeID L/E: solo lectura Tipo: VT_U12 Valor predeterminado: 0 Descripción: identificador de cálculo de una fila que es el resultado de una cláusula COMPUTE de la instrucción SELECT de Transact-SQL actual. Éste es el equivalente en el proveedor OLE DB de SQL Server Native Client del atributo SQL_CA_SS_COMPUTE_ID de OBDC. |
SSPROP_DEFERPREPARE |
Columna: no L/E: lectura/escritura Tipo: 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 L/E: lectura/escritura Tipo: VT_BOOL Valor predeterminado: VARIANT_FALSE Descripción: establezca esta propiedad en VARIANT_TRUE para abrir un conjunto de filas de carga rápida a través de IOpenRowset::OpenRowset. No puede establecer esta propiedad en ICommandProperties::SetProperties. |
SSPROP_ISSAsynchStatus |
Columna: no L/E: lectura/escritura Tipo: VT_BOOL Valor predeterminado: VARIANT_FALSE Descripción: establezca esta propiedad en VARIANT_TRUE para habilitar las operaciones asincrónicas mediante el uso de la interfaz ISSAsynchStatus. |
SSPROP_MAXBLOBLENGTH |
Columna: no L/E: lectura/escritura Tipo: 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 de objetos binarios grandes (BLOB) devueltos por una instrucción SELECT. |
SSPROP_NOCOUNT_STATUS |
Columna: NoCount L/E: solo lectura Tipo: VT_BOOL Valor predeterminado: VARIANT_FALSE Descripción: valor booleano que representa el estado SET NOCOUNT ON/OFF de SQL Server: VARIANT_TRUE: cuando SET NOCOUNT ON VARIANT_FALSE: cuando SET NOCOUNT OFF |
SSPROP_QP_NOTIFICATION_MSGTEXT |
Columna: no L/E: lectura/escritura Tipo: 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 L/E: lectura/escritura Tipo: 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 L/E: lectura/escritura Tipo: VT_UI4 Valor predeterminado: 432000 segundos (5 días) Mínimo: 1 segundo Máximo: 2^31-1 segundos Descripción: número de segundos que la notificación de consulta va a permanecer activa. |