Compatibilidad con tipos de parámetros con valores de tabla de OLE DB (propiedades)

En este tema se proporciona información sobre las propiedades de OLE DB y los conjuntos de propiedades asociados a los objetos de conjunto de filas de parámetro con valores de tabla.

Propiedades

A continuación figura la lista de propiedades expuestas mediante el método IRowsetInfo::GetPropeties en los objetos de conjunto de filas de parámetro con valores de tabla. Observe que todas las propiedades de conjunto de filas de parámetro con valores de tabla son de solo lectura. Por lo tanto, si se intenta establecer cualquiera de las propiedades mediante los métodos IOpenRowset::OpenRowset o ITableDefinitionWithConstraints::CreateTableWithConstraints en sus valores no predeterminados, se producirá un error y no se creará ningún objeto.

No se enumeran aquí las propiedades no implementadas en el objeto de conjunto de filas de parámetro con valores. Para obtener una lista completa de las propiedades, vea la documentación de OLE DB en Data Access Components para Windows.

Id. de propiedad	Valor
DBPROP_ABORTPRESERVE	VARIANT_TRUE
DBPROP_ACCESSORDER	DBPROPVAL_AO_RANDOM
DBPROP_BLOCKINGSTORAGEOBJECTS	VARIANT_TRUE
DBPROP_BOOKMARKS DBPROP_LITERALBOOKMARKS	L/E: de solo lectura Valor predeterminado: VARIANT_FALSE Descripción: no se permiten marcadores en los objetos de conjunto de filas de parámetro con valores de tabla.
DBPROP_BOOKMARKSKIPPED	VARIANT_FALSE
DBPROP_BOOKMARKTYPE	DBPROPVAL_BMK_NUMERIC
DBPROP_CANHOLDROWS	VARIANT_FALSE
DBPROP_CHANGEINSERTEDROWS	VARIANT_TRUE
DBPROP_COLUMNRESTRICT	VARIANT_FALSE
DBPROP_COMMANDTIMEOUT	0
DBPROP_COMMITPRESERVE	VARIANT_TRUE
DBPROP_DEFERRED	VARIANT_FALSE
DBPROP_DELAYSTORAGEOBJECTS	VARIANT_FALSE
DBPROP_IAccessor DBPROP_IColumnsInfo DBPROP_IConvertType DBPROP_IRowset DBPROP_IRowsetInfo DBPROP_IColumnsRowset	VARIANT_TRUE
DBPROP_IConnectionPointContainer DBPROP_IMultipleResults DBPROP_IRowsetUpdate DBPROP_IRowsetIdentity DBPROP_IRowsetLocate DBPROP_IRowsetScroll DBPROP_IRowsetResynch	VARIANT_FALSE
DBPROP_IRowsetChange	VARIANT_TRUE Nota: el objeto de conjunto de filas de parámetro con valores de tabla admite las interfaces IRowsetChange. Los conjuntos de filas creados utilizando DBPROP_IRowsetChange igual a VARIANT_TRUE exhiben los comportamientos de modo de actualización inmediatos. Sin embargo, si las columnas BLOB se enlazan como objetos ISequentialStream, se espera que el consumidor las mantenga durante la duración del objeto de conjunto de filas de parámetro con valores de tabla.
DBPROP_ISupportErrorInfo	VARIANT_TRUE
DBPROP_ISequentialStream	VARIANT_TRUE
DBPROP_IMMOBILEROWS	VARIANT_TRUE
DBPROP_LITERALIDENTITY	VARIANT_TRUE
DBPROP_LOCKMODE	DBPROPVAL_LM_NONE
DBPROP_MAXOPENROWS	0
DBPROP_MAXPENDINGROWS	0
DBPROP_MAXROWS	0
DBPROP_NOTIFICATIONPHASES	0
DBPROP_NOTIFYCOLUMNSET DBPROP_NOTIFYROWDELETE DBPROP_NOTIFYROWFIRSTCHANGE DBPROP_NOTIFYROWINSERT DBPROP_NOTIFYROWRESYNCH DBPROP_NOTIFYROWSETRELEASE DBPROP_NOTIFYROWSETFETCH-POSITIONCHANGE DBPROP_NOTIFYROWUNDOCHANGE DBPROP_NOTIFYROWUNDODELETE DBPROP_NOTIFYROWUNDOINSERT DBPROP_NOTIFYROWUPDATE	0
DBPROP_OTHERINSERT DBPROP_OTHERUPDATEDELETE	VARIANT_FALSE
DBPROP_OWNINSERT DBPROP_OWNUPDATEDELETE	VARIANT_TRUE
DBPROP_QUICKRESTART	VARIANT_TRUE
DBPROP_REENTRANTEVENTS	VARIANT_FALSE
DBPROP_REMOVEDELETED	VARIANT_TRUE
DBPROP_RETURNPENDINGINSERTS	VARIANT_TRUE
DBPROP_ROWRESTRICT	VARIANT_FALSE
DBPROP_ROWTHREADMODEL	DBPROPVAL_RT_FREETHREAD
DBPROP_SERVERCURSOR	VARIANT_FALSE
DBPROP_SERVERDATAONINSERT	VARIANT_FALSE
DBPROP_STRONGIDENTITY	VARIANT_TRUE
DBPROP_TRANSACTEDOBJECT	VARIANT_FALSE
DBPROP_UNIQUEROWS	VARIANT_FALSE
DBPROP_UPDATABILITY	DBPROPVAL_UP_CHANGE | DBPROPVAL_UP_DELETE | DBPROPVAL_UP_INSERT

Conjuntos de propiedades

La propiedad siguiente establece los parámetros con valores de tabla admitidos.

DBPROPSET_SQLSERVERCOLUMN

El consumidor utiliza esta propiedad en el proceso de crear un objeto de conjunto de filas de parámetro con valores de tabla utilizando ITableDefinitionWithConstraints::CreateTableWithConstraints para cada columna a través de la estructura DBCOLUMNDESC, si es necesario.

Id. de propiedad	Valor de la propiedad
SSPROP_COL_COMPUTED	L/E: de lectura/escritura Valor predeterminado: VARIANT_FALSE Tipo: VT_BOOL Descripción: cuando se establece en VARIANT_TRUE, indica que la columna es calculada. VARIANT_FALSE indica que no es una columna calculada.

DBPROPSET_SQLSERVERPARAMETER

El consumidor lee estas propiedades mientras se detecta la información del tipo de parámetro con valores de tabla en las llamadas a ISSCommandWithParamters::GetParameterProperties y el consumidor las establece al mismo tiempo que las propiedades concretas sobre el parámetro con valores de tabla a través de ISSCommandWithParameters::SetParameterProperties.

En la tabla siguiente se proporcionan descripciones detalladas de estas propiedades.

Id. de propiedad	Valor de la propiedad
SSPROP_PARAM_TYPE_TYPENAME	L/E: de lectura/escritura Valor predeterminado: VT_EMPTY Tipo: VT_BSTR Descripción: los consumidores utilizan esta propiedad para obtener o establecer el nombre del tipo de parámetro con valores de tabla. Esta propiedad se puede utilizar también con tipos definidos por el usuario CLR. Esta propiedad se puede especificar opcionalmente para proporcionar un nombre de tipo de tabla para un parámetro con valores de tabla (en caso del comando de sintaxis de llamada ODBC). Esta propiedad es necesaria para las consultas SQL parametrizadas ad hoc.
SSPROP_PARAM_TYPE_SCHEMANAME	L/E: de lectura/escritura Valor predeterminado: VT_EMPTY Tipo: VT_BSTR Descripción: los consumidores utilizan esta propiedad para obtener o establecer el nombre de esquema del tipo de parámetro con valores de tabla. Esta propiedad se puede utilizar también con tipos definidos por el usuario CLR.
SSPROP_PARAM_TYPE_CATALOGNAME	L/E: de solo lectura Valor predeterminado: VT_EMPTY Tipo: VT_BSTR Descripción: los consumidores utilizan esta propiedad para obtener el nombre de catálogo del tipo de parámetro con valores de tabla. Esta propiedad se puede utilizar también con tipos definidos por el usuario CLR. Es un error establecer esta propiedad; los tipos de tabla definidos por el usuario deben estar en la misma base de datos que los parámetros con valores de tabla que los usan.
SSPROP_PARAM_TABLE_DEFAULT_COLUMNS	L/E: de lectura/escritura Valor predeterminado: VT_EMPTY Tipo: VT_UI2 | VT_ARRAY Descripción: los consumidores usan esta propiedad para especificar qué conjunto de columnas del conjunto de filas será tratado como valores predeterminados. No se enviará ningún valor para esas columnas. Al capturar datos del objeto de conjunto de filas del consumidor, el proveedor no requiere un enlace para tales columnas. Todos los elementos de la matriz deben ser ordinales de columnas del objeto de conjunto de filas. Los ordinales no válidos producirán errores durante la ejecución del comando.
SSPROP_PARAM_TABLE_COLUMN_ORDER	L/E: de lectura/escritura Valor predeterminado: VT_EMPTY Tipo: VT_UI2 | VT_ARRAY Descripción: el consumidor utiliza esta propiedad para proporcionar una sugerencia al servidor que indica el orden de clasificación de los datos de columna. El proveedor no realiza ninguna validación y asume que el consumidor se ajusta a la especificación que se proporcionó. El servidor usa esta propiedad para realizar las optimizaciones. La información de orden de las columnas para cada columna se representa mediante un par de elementos de la matriz. El primer elemento del par es el número de la columna. El segundo elemento del par será 1 para el orden ascendente o 2 para el orden descendente.

Vea también

Tasks

Usar parámetros con valores de tabla (OLE DB)

Conceptos

Compatibilidad con tipos de parámetros con valores de tablas de OLE DB