行集属性和行为

以下是 SQL Server Native Client OLE DB 访问接口行集属性。

属性 ID

说明

DBPROP_ABORTPRESERVE

R/W:读/写

默认值:VARIANT_FALSE

说明:行集在某个中止操作后的行为由此属性确定。

VARIANT_FALSE:SQL Server Native Client OLE DB 访问接口在某个中止操作之后使行集失效。行集对象的功能几乎丢失。它只支持 IUnknown 操作以及释放未完成的行和取值函数句柄。

VARIANT_TRUE:SQL Server Native Client OLE DB 访问接口保持有效的行集。

DBPROP_ACCESSORDER

R/W:读/写

默认值:DBPROPVAL_AO_RANDOM

说明:访问顺序。访问行集中的列时必须遵照的顺序。

DBPROPVAL_AO_RANDOM:可以按任意顺序访问列。

DBPROPVAL_AO_SEQUENTIALSTORAGEOBJECTS:只能按照由列序号确定的顺序依次访问绑定为存储对象的列。

DBPROPVAL_AO_SEQUENTIAL:所有列都必须按照由列序号确定的顺序依次访问。

DBPROP_APPENDONLY

SQL Server Native Client OLE DB 访问接口不实现此行集属性。尝试读取或写入属性值将生成错误。

DBPROP_BLOCKINGSTORAGEOBJECTS

R/W:只读

默认值:VARIANT_TRUE

说明:SQL Server Native Client OLE DB 访问接口存储对象阻止使用其他行集方法。

DBPROP_BOOKMARKS DBPROP_LITERALBOOKMARKS

R/W:读/写

默认值:VARIANT_FALSE

说明:SQL Server Native Client OLE DB 访问接口支持在 DBPROP_BOOKMARKS 或 DBPROP_LITERALBOOKMARKS 为 VARIANT_TRUE 时使用书签来标识行集的行。

将其中任一属性设置为 VARIANT_TRUE 都不会启用按书签为行集定位。将 DBPROP_IRowsetLocate 或 DBPROP_IRowsetScroll 设置为 VARIANT_TRUE 可创建支持按书签为行集定位的行集。

SQL Server Native Client OLE DB 访问接口使用 MicrosoftSQL Server 游标以支持包含书签的行集。有关详细信息,请参阅行集和 SQL Server 游标

注意注意
当设置的这些属性与 SQL Server Native Client OLE DB 访问接口的其他游标定义的属性相冲突时,将导致错误。例如,如果将 DBPROP_BOOKMARKS 设置为 VARIANT_TRUE 且 DBPROP_OTHERINSERT 也为 VARIANT_TRUE,那么,当使用者尝试打开行集时,将生成错误。

DBPROP_BOOKMARKSKIPPED

R/W:只读

默认值:VARIANT_FALSE

说明:如果在定位或搜索带书签的行集时,使用者指示某个书签无效,则 SQL Server Native Client OLE DB 访问接口返回 DB_E_BADBOOKMARK。

DBPROP_BOOKMARKTYPE

R/W:只读

默认值:DBPROPVAL_BMK_NUMERIC

说明:SQL Server Native Client OLE DB 访问接口只实现数字书签。SQL Server Native Client OLE DB 访问接口书签为 32 位无符号整数,类型为 DBTYPE_UI4。

DBPROP_CACHEDEFERRED

SQL Server Native Client OLE DB 访问接口不实现此行集属性。尝试读取或写入属性值将生成错误。

DBPROP_CANFETCHBACKWARDS DBPROP_CANSCROLLBACKWARDS

R/W:读/写

默认值:VARIANT_FALSE

说明:SQL Server Native Client OLE DB 访问接口支持在非序列行集中进行向后提取和回滚。当 DBPROP_CANFETCHBACKWARDS 或 DBPROP_CANSCROLLBACKWARDS 为 VARIANT_TRUE 时,SQL Server Native Client OLE DB 访问接口创建一个游标支持的行集。有关详细信息,请参阅行集和 SQL Server 游标

DBPROP_CANHOLDROWS

R/W:读/写

默认值:VARIANT_FALSE

说明:默认情况下,如果某行集中当前存在对于多个行的挂起更改,而使用者试图获得这些行,则 SQL Server Native Client OLE DB 访问接口将返回 DB_E_ROWSNOTRELEASED。可以修改此行为。

将 DBPROP_CANHOLDROWS 和 DBPROP_IRowsetChange 同时设置为 VARIANT_TRUE 意味着行集带有书签。如果这两个属性均为 VARIANT_TRUE,则 IRowsetLocate 接口可用于行集,并且 DBPROP_BOOKMARKS 和 DBPROP_LITERALBOOKMARKS 同时为 VARIANT_TRUE。

SQL Server 游标支持包含书签的 SQL Server Native Client OLE DB 访问接口行集。

DBPROP_CHANGEINSERTEDROWS

R/W:读/写

默认值:VARIANT_FALSE

说明:如果行集正在使用由键集驱动的游标,则此属性只能设置为 VARIANT_TRUE。

DBPROP_COLUMNRESTRICT

R/W:只读

默认值:VARIANT_FALSE

说明:当使用者无法更改行集中的某列时,SQL Server Native Client OLE DB 访问接口将此属性设置为 VARIANT_TRUE。可以更新行集中的其他列,并且可以删除行本身。

当此属性为 VARIANT_TRUE 时,使用者将检查 DBCOLUMNINFO 结构的 dwFlags 成员,以确定能否写入单独列的值。对于可修改的列,dwFlags 展现 DBCOLUMNFLAGS_WRITE。

DBPROP_COMMANDTIMEOUT

R/W:读/写

默认值:0

说明:默认情况下,SQL Server Native Client OLE DB 访问接口对于 ICommand::Execute 方法不超时。

DBPROP_COMMITPRESERVE

R/W:读/写

默认值:VARIANT_FALSE

说明:行集在某个提交操作后的行为由此属性确定。

VARIANT_TRUE:SQL Server Native Client OLE DB 访问接口保持有效的行集。

VARIANT_FALSE:SQL Server Native Client OLE DB 访问接口在某个提交操作之后使行集失效。行集对象的功能几乎丢失。它只支持 IUnknown 操作以及释放未完成的行和取值函数句柄。

DBPROP_DEFERRED

R/W:读/写

默认值:VARIANT_FALSE

说明:当设置为 VARIANT_TRUE 时,SQL Server Native Client OLE DB 访问接口尝试将服务器游标用于行集。将不会从服务器返回 Textntextimage 列,直到应用程序访问它们。

DBPROP_DELAYSTORAGEOBJECTS

R/W:只读

默认值:VARIANT_FALSE

说明:SQL Server Native Client OLE DB 访问接口对于存储对象支持立即更新模式。

对连续流对象中的数据所做的更改将立即提交到 SQL Server。将基于行集事务模式提交修改。

DBPROP_HIDDENCOLUMNS

R/W:只读

默认值:VARIANT_FALSE

说明:隐藏列计数

如果 DBPROP_UNIQUEROWS 为 VARIANT_TRUE,则 DBPROP_HIDDENCOLUMNS 属性返回由访问接口添加的唯一标识行集中各行的其他“隐藏”列的数量。这些列由 IColumnsInfo::GetColumnInfoIColumnsRowset::GetColumnsRowset 返回。然而,它们不包含在由 pcColumns 参数(由 IColumnsInfo::GetColumnInfo 返回)返回的行计数中。

为了确定由 IColumnsInfo::GetColumnInfo 返回的以 prgInfo 结构表示的总列数(包括隐藏列),使用者将 DBPROP_HIDDENCOLUMNS 的值添加到从 pcColumnsIColumnsInfo::GetColumnInfo 中返回的列计数。如果 DBPROP_UNIQUEROWS 为 VARIANT_FALSE,则 DBPROP_HIDDENCOLUMNS 为零。

DBPROP_IAccessor DBPROP_IColumnsInfo DBPROP_IConvertType DBPROP_IRowset DBPROP_IRowsetInfo

R/W:只读

默认值:VARIANT_TRUE

说明:SQL Server Native Client OLE DB 访问接口对于所有行集支持这些接口。

DBPROP_IColumnsRowset

R/W:读/写

默认值:VARIANT_TRUE

说明:SQL Server Native Client OLE DB 访问接口支持 IColumnsRowset 接口。

DBPROP_IConnectionPointContainer

R/W:读/写

默认值:VARIANT_FALSE

说明:IConnectionPointContainer。如果为 VARIANT_TRUE,则行集支持指定的接口。如果为 VARIANT_FALSE,则行集不支持指定的接口。支持某接口的访问接口必须支持与该接口关联的且值为 VARIANT_TRUE 的属性。这些属性主要用于通过 ICommandProperties::SetProperties 请求接口。

DBPROP_IMultipleResults

R/W:读/写

默认值:VARIANT_FALSE

说明:SQL Server Native Client OLE DB 访问接口支持 IMultipleResults 接口。

DBPROP_IRowsetChange DBPROP_IRowsetUpdate

R/W:读/写

默认值:VARIANT_FALSE

说明:SQL Server Native Client OLE DB 访问接口支持 IRowsetChangeIRowsetUpdate 接口。

通过使用 DBPROP_IRowsetChange 等于 VARIANT_TRUE 而创建的行集将展现立即更新模式行为。

当 DBPROP_IRowsetUpdate 为 VARIANT_TRUE 时,DBPROP_IRowsetChange 也为 VARIANT_TRUE。行集展现延迟的更新模式行为。

SQL Server Native Client OLE DB 访问接口使用 SQL Server 游标以支持显示 IRowsetChangeIRowsetUpdate 的行集。有关详细信息,请参阅行集和 SQL Server 游标

DBPROP_IRowsetIdentity

R/W:读/写

默认值:VARIANT_TRUE

说明:SQL Server Native Client OLE DB 访问接口支持 IRowsetIdentity 接口。如果行集支持此接口,则任何表示同一基础行的两个句柄将始终反映相同的数据和状态。使用者可以调用 IRowsetIdentity:: IsSameRow 方法来比较两个行句柄,以查看它们是否引用同一个行实例。

DBPROP_IRowsetLocate DBPROP_IRowsetScroll

R/W:读/写

默认值:VARIANT_FALSE

说明:SQL Server Native Client OLE DB 访问接口可以显示 IRowsetLocateIRowsetScroll 接口。

当 DBPROP_IRowsetLocate 为 VARIANT_TRUE 时,DBPROP_CANFETCHBACKWARDS 和 DBPROP_CANSCROLLBACKWARDS 也为 VARIANT_TRUE。

当 DBPROP_IRowsetScroll 为 VARIANT_TRUE 时,DBPROP_IRowsetLocate 也为 VARIANT_TRUE,并且这两个接口可用于行集。

每个接口都要求书签。当使用者请求任一接口时,SQL Server Native Client OLE DB 访问接口将 DBPROP_BOOKMARKS 和 DBPROP_LITERALBOOKMARKS 设置为 VARIANT_TRUE。

SQL Server Native Client OLE DB 访问接口使用 SQL Server 游标以支持 IRowsetLocateIRowsetScroll。有关详细信息,请参阅行集和 SQL Server 游标

当设置的这些属性与 SQL Server Native Client OLE DB 访问接口的其他游标定义的属性相冲突时,将导致错误。例如,如果将 DBPROP_IRowsetScroll 设置为 VARIANT_TRUE(此时,DBPROP_OTHERINSERT 也为 VARIANT_TRUE),当使用者尝试打开行集时,将生成错误。

DBPROP_IRowsetResynch

R/W:读/写

默认值:VARIANT_FALSE

说明:SQL Server Native Client OLE DB 访问接口按需显示 IRowsetResynch 接口。SQL Server Native Client OLE DB 访问接口可以对于任何行集显示此接口。

DBPROP_ISupportErrorInfo

R/W:读/写

默认值:VARIANT_TRUE

说明:SQL Server Native Client OLE DB 访问接口对于行集显示 ISupportErrorInfo 接口。

DBPROP_ILockBytes

SQL Server Native Client OLE DB 访问接口不实现此接口。尝试读取或写入此属性将生成错误。

DBPROP_ISequentialStream

R/W:读/写

默认值:VARIANT_FALSE

说明:SQL Server Native Client OLE DB 访问接口显示 ISequentialStream 接口以支持 SQL Server 中存储的长的、可变长度的数据。

DBPROP_IStorage

SQL Server Native Client OLE DB 访问接口不实现此接口。尝试读取或写入此属性将生成错误。

DBPROP_IStream

SQL Server Native Client OLE DB 访问接口不实现此接口。尝试读取或写入此属性将生成错误。

DBPROP_IMMOBILEROWS

R/W:读/写

默认值:VARIANT_TRUE

说明:此属性仅对于 SQL Server 键集游标为 VARIANT_TRUE;对于所有其他游标,它为 VARIANT_FALSE。

VARIANT_TRUE:行集将不对插入或更新的行重新排序。对于 IRowsetChange::InsertRow,行将出现在行集的末尾。对于 IRowsetChange::SetData,如果行集未排序,则已更新的行的位置不会变化。如果行集已排序,并且 IRowsetChange::SetData 更改了用于对行集排序的列,则不移动该行。如果行集建立在一组键列之上(通常是 DBPROP_OTHERUPDATEDELETE 为 VARIANT_TRUE 但 DBPROP_OTHERINSERT 为 VARIANT_FALSE 的行集),则更改某个键列的值通常等效于删除当前行并插入新行。因此,如果 DBPROP_OWNINSERT 为 VARIANT_FALSE,则行可能从行集中移动,或甚至消失,即使 DBPROP_IMMOBILEROWS 属性为 VARIANT_TRUE,也不例外。

VARIANT_FALSE:如果对行集排序,则插入的行将以行集的正确顺序出现。如果未对行集排序,则插入的行将出现在末尾。如果 IRowsetChange::SetData 更改了用于对行集排序的列,则移动该行。如果未对行集排序,则不更改行的位置。

DBPROP_LITERALIDENTITY

R/W:只读

默认值:VARIANT_TRUE

说明:此属性始终为 VARIANT_TRUE。

DBPROP_LOCKMODE

R/W:读/写

默认值:DBPROPVAL_LM_NONE

说明:由行集执行的锁定级别(DBPROPVAL_LM_NONE、DBPROPVAL_LM_SINGLEROW)。

注意注意
当在事务中使用快照隔离时,如果通过使用键集游标或动态服务器游标打开行集并且锁定模式设置为 DBPROPVAL_LM_SINGLEROW,则在自启动此事务之后其他人已更新了某行的情况下提取该行时,将出现错误。对于其他游标类型和锁定模式,如果在自启动此事务之后其他人已更新了该行,则在该用户尝试更新此行之前,不会发生错误。在这两种情况下,服务器将生成这些错误。

DBPROP_MAXOPENROWS

R/W:只读

默认值:0

说明:SQL Server Native Client OLE DB 访问接口不限制行集中可以处于活动状态的行数。

DBPROP_MAXPENDINGROWS

R/W:只读

默认值:0

说明:SQL Server Native Client OLE DB 访问接口不限制行集中处于更改挂起状态的行数。

DBPROP_MAXROWS

R/W:读/写

默认值:0

说明:默认情况下,SQL Server Native Client OLE DB 访问接口不限制行集中的行数。当使用者设置 DBPROP_MAXROWS 时,SQL Server Native Client OLE DB 访问接口使用 SET ROWCOUNT 语句限制行集中的行数。

SET ROWCOUNT 可能在执行 SQL Server 语句的过程中导致意外后果。有关详细信息,请参阅 SET ROWCOUNT

DBPROP_MAYWRITECOLUMN

SQL Server Native Client OLE DB 访问接口不实现此行集属性。尝试读取或写入属性值将生成错误。

DBPROP_MEMORYUSAGE

SQL Server Native Client OLE DB 访问接口不实现此行集属性。尝试读取或写入属性值将生成错误。

DBPROP_NOTIFICATIONGRANULARITY

SQL Server Native Client OLE DB 访问接口不实现此行集属性。尝试读取或写入属性值将生成错误。

DBPROP_NOTIFICATIONPHASES

R/W:只读

默认值:DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO | DBPROPVAL_NP_SYNCHAFTER | DBPROPVAL_NP_FAILEDTODO | DBPROPVAL_NP_DIDEVENT

说明:SQL Server Native Client OLE DB 访问接口支持所有通知阶段。

DBPROP_NOTIFYCOLUMNSET DBPROP_NOTIFYROWDELETE DBPROP_NOTIFYROWFIRSTCHANGE DBPROP_NOTIFYROWINSERT DBPROP_NOTIFYROWRESYNCH DBPROP_NOTIFYROWSETRELEASE DBPROP_NOTIFYROWSETFETCH-POSITIONCHANGE DBPROP_NOTIFYROWUNDOCHANGE DBPROP_NOTIFYROWUNDODELETE DBPROP_NOTIFYROWUNDOINSERT DBPROP_NOTIFYROWUPDATE

R/W:只读

默认值:DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO

说明:在尝试执行所指示的行集修改之前,SQL Server Native Client OLE DB 访问接口通知阶段是可取消的。SQL Server Native Client OLE DB 访问接口不支持在完成尝试之后取消阶段。

DBPROP_ORDEREDBOOKMARKS

SQL Server Native Client OLE DB 访问接口不实现此行集属性。尝试读取或写入属性值将生成错误。

DBPROP_OTHERINSERT DBPROP_OTHERUPDATEDELETE DBPROP_OWNINSERT DBPROP_OWNUPDATEDELETE

R/W:读/写

默认值:VARIANT_FALSE

说明:设置更改可见性属性会导致 SQL Server Native Client OLE DB 访问接口使用 SQL Server 游标以支持行集。有关详细信息,请参阅行集和 SQL Server 游标

DBPROP_QUICKRESTART

R/W:读/写

默认值:VARIANT_FALSE

说明:当设置为 VARIANT_TRUE 时,SQL Server Native Client OLE DB 访问接口尝试将服务器游标用于行集。

DBPROP_REENTRANTEVENTS

R/W:只读

默认值:VARIANT_TRUE

说明:SQL Server Native Client OLE DB 访问接口行集属于重入行集,如果使用者尝试从通知回调中访问非重入行集方法,则它们可能返回 DB_E_NOTREENTRANT。

DBPROP_REMOVEDELETED

R/W:读/写

默认值:VARIANT_FALSE

说明:SQL Server Native Client OLE DB 访问接口根据对由行集显示的 SQL Server 数据所做更改的可见性,修改此属性的值。

VARIANT_TRUE:当刷新行集时,将从行集中删除由使用者或其他 SQL Server 用户删除的行。DBPROP_OTHERINSERT 为 VARIANT_TRUE。

VARIANT_FALSE:当刷新行集时,将不从行集中删除由使用者或其他 SQL Server 用户删除的行。行集中已删除的 SQL Server 行的行状态值为 DBROWSTATUS_E_DELETED。DBPROP_OTHERINSERT 为 VARIANT_TRUE。

此属性仅对于 SQL Server 游标支持的行集具有值。有关详细信息,请参阅行集和 SQL Server 游标

当对于键集游标行集实现 DBPROP_REMOVEDELETED 属性时,将在提取时删除已删除的行,并且,行提取方法(如 GetNextRowsGetRowsAt)可以同时返回 S_OK 和比要求数量更少的行。请注意,此行为并不指示 DB_S_ENDOFROWSET 条件,并且如果存在任何剩余的行,则返回的行数将从不会为零。

DBPROP_REPORTMULTIPLECHANGES

SQL Server Native Client OLE DB 访问接口不实现此行集属性。尝试读取或写入属性值将生成错误。

DBPROP_RETURNPENDINGINSERTS

R/W:只读

默认值:VARIANT_FALSE

说明:当调用提取行的方法时,SQL Server Native Client OLE DB 访问接口不返回挂起的插入行。

DBPROP_ROWRESTRICT

R/W:只读

默认值:VARIANT_TRUE

说明:SQL Server Native Client OLE DB 访问接口行集不支持基于行的访问权限。如果对于行集公开 IRowsetChange 接口,则使用者可以调用 SetData 方法:

DBPROP_ROWSET_ASYNCH

R/W:读/写

默认值:0

说明:为异步行集处理而提供。此属性位于行集属性组和 DBPROPSET_ROWSET 属性集中。类型为 VT_14。

SQL Server Native Client 支持的位掩码中的唯一值是 DBPROPVAL_ASYNCH_INITIALIZE。

DBPROP_ROWTHREADMODEL

R/W:只读

默认值:DBPROPVAL_RT_FREETHREAD

描述:SQL Server Native Client OLE DB 访问接口支持从单个使用者的多个执行线程访问其对象。

DBPROP_SERVERCURSOR

R/W:读/写

默认值:VARIANT_FALSE

说明:设置后,SQL Server 游标将用于支持行集。有关详细信息,请参阅行集和 SQL Server 游标

DBPROP_SERVERDATAONINSERT

R/W:读/写

默认值:VARIANT_FALSE

说明:插入的服务器数据。

VARIANT_TRUE:在将插入传输到服务器时,访问接口将从服务器检索数据以更新本地行缓存。

VARIANT_FALSE:访问接口不针对新插入的行检索服务器值。

DBPROP_STRONGIDENTITY

R/W:只读

默认值:VARIANT_TRUE

说明:强的行标识。如果行集允许插入(IRowsetChangeIRowsetUpdate 为 true),并且 DBPROP_UPDATABILITY 设置为支持 InsertRows,则 DBPROP_STRONGIDENTITY 的值取决于 DBPROP_CHANGEINSERTEDROWS 属性(如果 DBPROP_CHANGEINSERTEDROWS 属性值为 VARIANT_FALSE,则为 VARIANT_FALSE)。

DBPROP_TRANSACTEDOBJECT

R/W:只读

默认值:VARIANT_FALSE

说明:SQL Server Native Client OLE DB 访问接口只支持事务对象。有关详细信息,请参阅事务

DBPROP_UNIQUEROWS

R/W:读/写

默认值:VARIANT_FALSE

说明:唯一行。

VARIANT_TRUE:每行由其列值唯一标识。唯一标识此行的列集在从 GetColumnInfo 方法返回的 DBCOLUMNINFO 结构中设置了 DBCOLUMNFLAGS_KEYCOLUMN。

VARIANT_FALSE:行可能(也可能不)由其列值唯一标识。键列可能(也可能不)由 DBCOLUMNFLAGS_KEYCOLUMN 进行标记。

DBPROP_UPDATABILITY

R/W:读/写

默认值:0

说明:SQL Server Native Client OLE DB 访问接口支持所有 DBPROP_UPDATABILITY 值。设置 DBPROP_UPDATABILITY 并不创建可修改的行集。为了使行集变得可修改,请设置 DBPROP_IRowsetChange 或 DBPROP_IRowsetUpdate。

SQL Server Native Client OLE DB 访问接口定义访问接口特定的属性集 DBPROPSET_SQLSERVERROWSET,如下表中所示。

属性 ID

说明

SSPROP_COLUMN_ID

列:ColumnID

R/W:只读

类型:VT_U12 | VT_ARRAY

默认值:VT_EMPTY

说明:表示当前 Transact-SQL SELECT 语句中的 COMPUTE 子句结果列的序号位置(从 1 开始)的整数值数组。这是 SQL Server Native Client OLE DB 访问接口中等效于 ODBC SQL_CA_SS_COLUMN_ID 属性的属性。

SSPROP_COMPUTE_BYLIST

列:ComputeByList

R/W:只读

类型:VT_BOOL

默认值:VARIANT_FALSE

说明:指示列是 COMPUTE BY 结果集一部分的布尔值。这是 SQL Server Native Client OLE DB 访问接口中等效于 ODBC SQL_CA_SS_COMPUTE_BYLIST 属性的属性。

注意注意
OLE DB 属性是一个布尔值,但 ODBC 属性实际上是将所有列序号作为 BY 子句一部分的无符号短值的列表。

VARIANT_TRUE:此列来自 COMPUTE BY 语句。

VARIANT_FALSE:此列为常规列;它并非来自 COMPUTE BY 语句。

SSPROP_COMPUTE_ID

列:ComputeID

R/W:只读

类型:VT_U12

默认值:0

说明:作为当前 Transact-SQL SELECT 语句中 COMPUTE 子句的结果的行的计算 ID。这是 SQL Server Native Client OLE DB 访问接口中等效于 ODBC SQL_CA_SS_COMPUTE_ID 属性的属性。

SSPROP_DEFERPREPARE

列:No

R/W:读/写

类型:VT_BOOL

默认值:VARIANT_TRUE

说明:VARIANT_TRUE:在准备好的执行中,推迟命令准备,直到调用 ICommand::Execute 或执行元属性操作。如果此属性设置为

VARIANT_FALSE:当执行 ICommandPrepare::Prepare 时,将准备好此语句。

SSPROP_IRowsetFastLoad

列:No

R/W:读/写

类型:VT_BOOL

默认值:VARIANT_FALSE

说明:将此属性设置为 VARIANT_TRUE 以通过 IOpenRowset::OpenRowset 打开快速加载行集。在 ICommandProperties::SetProperties 中不能设置此属性。

SSPROP_ISSAsynchStatus

列:No。

R/W:读/写

类型:VT_BOOL

默认值:VARIANT_FALSE

说明:如果将此属性设置为 VARIANT_TRUE,则可以使用 ISSAsynchStatus 接口执行异步操作。

SSPROP_MAXBLOBLENGTH

列:No

R/W:读/写

类型:VT_I4

默认值:访问接口不限制由服务器返回的文本大小,并且此属性值设置为其最大值。例如,2147483647。

说明:SQL Server Native Client OLE DB 访问接口执行 SET TEXTSIZE 语句,以限制在 SELECT 语句中返回的二进制大型对象 (BLOB) 数据的长度。

SSPROP_NOCOUNT_STATUS

列:NoCount

R/W:只读

类型:VT_BOOL

默认值:VARIANT_FALSE

说明:一个布尔值,表示 SQL Server 中 SET NOCOUNT ON/OFF 的状态。

VARIANT_TRUE:当 SET NOCOUNT 为 ON 时

VARIANT_FALSE:当 SET NOCOUNT 为 OFF 时

SSPROP_QP_NOTIFICATION_MSGTEXT

列:No

R/W:读/写

类型:VT_BSTR(允许 1-2000 个字符)

默认值:空字符串

说明:查询通知的消息文本。这是用户定义的文本,没有确定的格式。

SSPROP_QP_NOTIFICATION_OPTIONS

列:No

R/W:读/写

类型:VT_BSTR

默认值:空字符串

说明:查询通知选项。在具有 name=value 的字符串中指定这些内容。用户负责创建服务并从队列中读取通知。查询通知选项字符串的语法为:

service=<service-name>[;(local database=<database>|broker instance=<broker instance>)]

例如:

service=mySSBService;local database=mydb

SSPROP_QP_NOTIFICATION_TIMEOUT

列:No

R/W:读/写

类型:VT_UI4

默认值:432000 秒(5 天)

最小值:1 秒

最大值:2^31-1 秒

说明:查询通知保持为活动状态的秒数。

更改历史记录

更新的内容

更新了对 DBPROP_ROWSET_ASYNCH 的说明。

请参阅

概念