Поделиться через


Свойства и поведение наборов строк

Применимо: SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure azure Synapse Analytics Analytics Platform System (PDW)

Скачать драйвер OLE DB

Ниже перечислены свойства набора строк OLE DB Driver for SQL Server.

Идентификатор свойства Description
DBPROP_ABORTPRESERVE R/W: чтение и запись

По умолчанию: VARIANT_FALSE

Описание: этим свойством определяется поведение набора строк после аварийного завершения операции.

VARIANT_FALSE. Драйвер OLE DB для SQL Server отменяет наборы строк после операции прерывания. Объект набора строк практически утратил свою функциональность. Он поддерживает только операции IUnknown, а также освобождение необработанных строк и обработчики методов доступа.

VARIANT_TRUE. Драйвер OLE DB для SQL Server поддерживает допустимый набор строк.
DBPROP_ACCESSORDER R/W: чтение и запись

По умолчанию: DBPROPVAL_AO_RANDOM

Описание: порядок доступа. Порядок, в котором должен осуществляться доступ к столбцам в наборе строк.

DBPROPVAL_AO_RANDOM. Доступ к столбцу можно получить в любом порядке.

DBPROPVAL_AO_SEQUENTIALSTORAGEOBJECTS. Столбцы, привязанные к объектам хранилища, могут быть доступны только в последовательном порядке, определяемом порядком столбца.

DBPROPVAL_AO_SEQUENTIAL: доступ ко всем столбцам должен осуществляться последовательно по порядковому номеру столбца.
DBPROP_APPENDONLY OLE DB Driver for SQL Server не реализует это свойство наборов строк. При попытке считать или записать значение свойства возникает ошибка.
DBPROP_BLOCKINGSTORAGEOBJECTS R/W: только для чтения

По умолчанию: VARIANT_TRUE

Описание. Блок объектов хранилища OLE DB для объектов хранилища SQL Server с помощью других методов набора строк.
DBPROP_BOOKMARKS DBPROP_LITERALBOOKMARKS R/W: чтение и запись

По умолчанию: VARIANT_FALSE

Описание: драйвер OLE DB для SQL Server поддерживает закладки для определения строки набора строк, если свойство DBPROP_BOOKMARKS или DBPROP_LITERALBOOKMARKS имеет значение VARIANT_TRUE.

Присвоение любому из этих свойств значения VARIANT_TRUE не включает позиционирование набора строк по закладке. Чтобы создать набор строк, поддерживающий позиционирование по закладке, присвойте свойству DBPROP_IRowsetLocate или DBPROP_IRowsetScroll значение VARIANT_TRUE.

Драйвер OLE DB для SQL Server использует курсор Microsoft SQL Server для поддержки набора строк, содержащего закладки. Дополнительные сведения см. в статье Наборы строк и курсоры SQL Server.

Примечание. При указании для этих свойств таких значений, которые конфликтуют с другими свойствами драйвера OLE DB для SQL Server, определяющими курсоры, возникает ошибка. Например, при попытке потребителя открыть набор строк, свойства DBPROP_BOOKMARKS и DBPROP_OTHERINSERT которого имеют значение VARIANT_TRUE, будет выдана ошибка.
DBPROP_BOOKMARKSKIPPED R/W: только для чтения

По умолчанию: VARIANT_FALSE

Описание: драйвер OLE DB для SQL Server вернет значение DB_E_BADBOOKMARK, если потребитель указал недопустимую закладку при позиционировании или поиске набора строк с закладками.
DBPROP_BOOKMARKTYPE R/W: только для чтения

По умолчанию: DBPROPVAL_BMK_NUMERIC

Описание. Драйвер OLE DB для SQL Server реализует только числовые закладки. Закладка OLE DB Driver for SQL Server — это 32-разрядное целое число без знака, имеющее тип DBTYPE_UI4.
DBPROP_CACHEDEFERRED OLE DB Driver for SQL Server не реализует это свойство наборов строк. При попытке считать или записать значение свойства возникает ошибка.
DBPROP_CANFETCHBACKWARDS DBPROP_CANSCROLLBACKWARDS R/W: чтение и запись

По умолчанию: VARIANT_FALSE

Описание. Драйвер OLE DB для SQL Server поддерживает обратную выборку и прокрутку в некачественных наборах строк. Если свойство DBPROP_CANFETCHBACKWARDS или DBPROP_CANSCROLLBACKWARDS имеет значение VARIANT_TRUE, то драйвер OLE DB для SQL Server создает набор строк, поддерживаемый курсорами. Дополнительные сведения см. в статье Наборы строк и курсоры SQL Server.
DBPROP_CANHOLDROWS R/W: чтение и запись

По умолчанию: VARIANT_FALSE

Описание. По умолчанию драйвер OLE DB для SQL Server возвращает DB_E_ROWSNOTRELEASED, если потребитель пытается получить больше строк для набора строк, пока ожидающие изменения существуют в строках в настоящее время в наборе строк. Это поведение может быть изменено.

Присвоение свойствам DBPROP_CANHOLDROWS и DBPROP_IRowsetChange значения VARIANT_TRUE подразумевает набор строк с закладками. Если оба свойства имеют значение VARIANT_TRUE, то для набора строк доступен интерфейс IRowsetLocate, а свойства DBPROP_BOOKMARKS и DBPROP_LITERALBOOKMARKS имеют значение VARIANT_TRUE.

Ole DB Driver for SQL Server rowsets, содержащих закладки, поддерживаются курсорами SQL Server.
DBPROP_CHANGEINSERTEDROWS R/W: чтение и запись

По умолчанию: VARIANT_FALSE

Описание: это свойство может иметь только значение VARIANT_TRUE, если набор строк использует курсор, управляемый набором ключей.
DBPROP_COLUMNRESTRICT R/W: только для чтения

По умолчанию: VARIANT_FALSE

Описание. Драйвер OLE DB для SQL Server задает свойство VARIANT_TRUE, если столбец в наборе строк не может быть изменен потребителем. Другие столбцы в наборе строк можно изменять, а сами строки — удалять.

Если это свойство имеет значение VARIANT_TRUE, то потребитель по элементу dwFlags структуры DBCOLUMNINFO определяет, может ли быть записано значение отдельного столбца. Для изменяемых столбцов элемент dwFlags принимает значение DBCOLUMNFLAGS_WRITE.
DBPROP_COMMANDTIMEOUT R/W: чтение и запись

По умолчанию: 0

Описание. По умолчанию драйвер OLE DB для SQL Server не истекает в методе ICommand::Execute .
DBPROP_COMMITPRESERVE R/W: чтение и запись

По умолчанию: VARIANT_FALSE

Описание: это свойство определяет поведение набора строк после выполнения фиксации.

VARIANT_TRUE. Драйвер OLE DB для SQL Server поддерживает допустимый набор строк.

VARIANT_FALSE. Драйвер OLE DB для SQL Server отменяет наборы строк после операции фиксации. Объект набора строк практически утратил свою функциональность. Он поддерживает только операции IUnknown, а также освобождение необработанных строк и обработчики методов доступа.
DBPROP_DEFERRED R/W: чтение и запись

По умолчанию: VARIANT_FALSE

Описание. Если задано значение VARIANT_TRUE драйвер OLE DB для SQL Server пытается использовать курсор сервера для набора строк. Столбцы типа text, ntext и image не возвращаются с сервера до тех пор, пока приложение не обратится к ним.
DBPROP_DELAYSTORAGEOBJECTS R/W: только для чтения

По умолчанию: VARIANT_FALSE

Описание. Драйвер OLE DB для SQL Server поддерживает режим немедленного обновления объектов хранилища.

Изменения, внесенные в данные в объекте последовательного потока, немедленно отправляются в SQL Server. Фиксация изменений производится в соответствии с режимом транзакций набора строк.
DBPROP_HIDDENCOLUMNS R/W: только для чтения

По умолчанию: VARIANT_FALSE

Описание: число скрытых столбцов

Если DBPROP_UNIQUEROWS имеет значение VARIANT_TRUE, то свойство DBPROP_HIDDENCOLUMNS возвращает число дополнительных «скрытых» столбцов, добавленных поставщиком для уникальной идентификации строк в наборе. Эти столбцы возвращаются методами IColumnsInfo::GetColumnInfo и IColumnsRowset::GetColumnsRowset. Однако они не включаются в число строк, которое возвращается в аргументе pcColumns метода IColumnsInfo::GetColumnInfo.

Чтобы выяснить общее число столбцов, представленных в структуре prgInfo, которую возвращает метод IColumnsInfo::GetColumnInfo (включая скрытые), потребитель должен добавить значение свойства DBPROP_HIDDENCOLUMNS к числу столбцов, возвращаемых методом IColumnsInfo::GetColumnInfo в pcColumns. Если свойство DBPROP_UNIQUEROWS имеет значение VARIANT_FALSE, то свойство DBPROP_HIDDENCOLUMNS равно нулю.
DBPROP_IAccessor DBPROP_IColumnsInfo DBPROP_IConvertType DBPROP_IRowset DBPROP_IRowsetInfo R/W: только для чтения

По умолчанию: VARIANT_TRUE

Описание. Драйвер OLE DB для SQL Server поддерживает эти интерфейсы во всех наборах строк.
DBPROP_IColumnsRowset R/W: чтение и запись

По умолчанию: VARIANT_TRUE

Описание. Драйвер OLE DB для SQL Server поддерживает интерфейс IColumnsRowset .
DBPROP_IConnectionPointContainer R/W: чтение и запись

По умолчанию: VARIANT_FALSE

Описание: IConnectionPointContainer. Если значение равно VARIANT_TRUE, то набор строк поддерживает заданный интерфейс. Если значение равно VARIANT_FALSE, то набор строк не поддерживает заданный интерфейс. Поставщики, поддерживающие тот или иной интерфейс, должны поддерживать связанное с этим интерфейсом свойство, которое возвращает значение VARIANT_TRUE. Эти свойства служат главным образом для запроса интерфейсов с помощью метода ICommandProperties::SetProperties.
DBPROP_IMultipleResults R/W: чтение и запись

По умолчанию: VARIANT_FALSE

Описание. Драйвер OLE DB для SQL Server поддерживает интерфейс IMultipleResults .
DBPROP_IRowsetChange DBPROP_IRowsetUpdate R/W: чтение и запись

По умолчанию: VARIANT_FALSE

Описание. Драйвер OLE DB для SQL Server поддерживает интерфейсы IRowsetChange и IRowsetUpdate .

Набор строк, созданный с DBPROP_IRowsetChange, равным VARIANT_TRUE, отражает режимы немедленного обновления.

Если DBPROP_IRowsetUpdate имеет значение VARIANT_TRUE, то DBPROP_IRowsetChange также имеет значение VARIANT_TRUE. Набор строк характеризуется поведением отложенного обновления.

Драйвер OLE DB для SQL Server использует курсор SQL Server для поддержки наборов строк, предоставляемых IRowsetChange или IRowsetUpdate. Дополнительные сведения см. в статье Наборы строк и курсоры SQL Server.
DBPROP_IRowsetIdentity R/W: чтение и запись

По умолчанию: VARIANT_TRUE

Описание. Драйвер OLE DB для SQL Server поддерживает интерфейс IRowsetIdentity . Если набор строк поддерживает этот интерфейс, то любые два дескриптора строк, относящихся к одной базовой строке, всегда представляют одни и те же данные и состояние. Потребители могут вызывать метод IRowsetIdentity:: IsSameRow для сравнения двух дескрипторов строк, чтобы узнать, ссылаются ли они на один и тот же экземпляр строки.
DBPROP_IRowsetLocate DBPROP_IRowsetScroll R/W: чтение и запись

По умолчанию: VARIANT_FALSE

Описание. Драйвер OLE DB для SQL Server может предоставлять интерфейсы IRowsetLocate и IRowsetScroll .

Если DBPROP_IRowsetLocate имеет значение VARIANT_TRUE, CANFETCHBACKWARDS и DBPROP_CANSCROLLBACKWARDS также имеют значение VARIANT_TRUE.

Если DBPROP_IRowsetScroll имеет значение VARIANT_TRUE, то DBPROP_IRowsetLocate также имеет значение VARIANT_TRUE, поэтому оба интерфейса доступны в наборе строк.

Закладки необходимы для обоих интерфейсов. Драйвер OLE DB для SQL Server присваивает свойствам DBPROP_BOOKMARKS и DBPROP_LITERALBOOKMARKS значение VARIANT_TRUE, если потребитель запрашивает один из этих интерфейсов.

Драйвер OLE DB для SQL Server использует курсоры SQL Server для поддержки IRowsetLocate и IRowsetScroll. Дополнительные сведения см. в статье Наборы строк и курсоры SQL Server.

При указании для этих свойств таких значений, которые конфликтуют с другими свойствами драйвера OLE DB для SQL Server, определяющими курсоры, возникает ошибка. Например, при попытке потребителя открыть набор строк, свойства DBPROP_IRowsetScroll и DBPROP_OTHERINSERT которого имеют значение VARIANT_TRUE, будет выдана ошибка.
DBPROP_IRowsetResynch R/W: чтение и запись

По умолчанию: VARIANT_FALSE

Описание. Драйвер OLE DB для SQL Server предоставляет интерфейс IRowsetResynch по запросу. OLE DB Driver for SQL Server может поддерживать интерфейс для любого набора строк.
DBPROP_ISupportErrorInfo R/W: чтение и запись

По умолчанию: VARIANT_TRUE

Описание. Драйвер OLE DB для SQL Server предоставляет интерфейс ISupportErrorInfo в наборах строк.
DBPROP_ILockBytes OLE DB Driver for SQL Server не реализует этот интерфейс. При попытке считать или записать свойство возникает ошибка.
DBPROP_ISequentialStream R/W: чтение и запись

По умолчанию: VARIANT_FALSE

Описание. Драйвер OLE DB для SQL Server предоставляет интерфейс ISequentialStream для поддержки длинных данных переменной длины, хранящихся в SQL Server.
DBPROP_IStorage OLE DB Driver for SQL Server не реализует этот интерфейс. При попытке считать или записать свойство возникает ошибка.
DBPROP_IStream OLE DB Driver for SQL Server не реализует этот интерфейс. При попытке считать или записать свойство возникает ошибка.
DBPROP_IMMOBILEROWS R/W: чтение и запись

По умолчанию: VARIANT_TRUE

Описание. Свойство VARIANT_TRUE только для курсоров набора ключей SQL Server; он 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

Описание. Драйвер OLE DB для SQL Server не ограничивает количество строк, которые могут быть активными в наборах строк.
DBPROP_MAXPENDINGROWS R/W: только для чтения

По умолчанию: 0

Описание. Драйвер OLE DB для SQL Server не ограничивает количество строк набора строк с ожидающих изменений.
DBPROP_MAXROWS R/W: чтение и запись

По умолчанию: 0

Описание. По умолчанию драйвер OLE DB для SQL Server не ограничивает количество строк в наборе строк. Если потребитель задал свойство DBPROP_MAXROWS, то драйвер OLE DB для SQL Server использует инструкцию SET ROWCOUNT для ограничения числа строк в наборе.

SET ROWCOUNT может привести к непредвиденным последствиям в выполнении инструкции SQL Server. Дополнительные сведения см. в разделе SET ROWCOUNT.
DBPROP_MAYWRITECOLUMN OLE DB Driver for SQL Server не реализует это свойство наборов строк. При попытке считать или записать значение свойства возникает ошибка.
DBPROP_MEMORYUSAGE OLE DB Driver for SQL Server не реализует это свойство наборов строк. При попытке считать или записать значение свойства возникает ошибка.
DBPROP_NOTIFICATIONGRANULARITY OLE DB Driver for SQL Server не реализует это свойство наборов строк. При попытке считать или записать значение свойства возникает ошибка.
DBPROP_NOTIFICATIONPHASES R/W: только для чтения

По умолчанию: DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO | DBPROPVAL_NP_SYNCHAFTER | DBPROPVAL_NP_FAILEDTODO | DBPROPVAL_NP_DIDEVENT

Описание. Драйвер OLE DB для SQL Server поддерживает все этапы уведомлений.
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

Описание. Этапы уведомлений OLE DB driver for SQL Server можно отменить перед попыткой изменения набора строк. OLE DB Driver for SQL Server не поддерживает отмену этапа после завершения попытки.
DBPROP_ORDEREDBOOKMARKS OLE DB Driver for SQL Server не реализует это свойство наборов строк. При попытке считать или записать значение свойства возникает ошибка.
DBPROP_OTHERINSERT DBPROP_OTHERUPDATEDELETE DBPROP_OWNINSERT DBPROP_OWNUPDATEDELETE R/W: чтение и запись

По умолчанию: VARIANT_FALSE

Описание. Настройка свойств видимости изменений приводит к тому, что драйвер OLE DB для SQL Server использует курсоры SQL Server для поддержки набора строк. Дополнительные сведения см. в статье Наборы строк и курсоры SQL Server.
DBPROP_QUICKRESTART R/W: чтение и запись

По умолчанию: VARIANT_FALSE

Описание. Если задано значение VARIANT_TRUE, драйвер OLE DB для SQL Server пытается использовать курсор сервера для набора строк.
DBPROP_REENTRANTEVENTS R/W: только для чтения

По умолчанию: VARIANT_TRUE

Описание: наборы строк драйвера OLE DB для SQL Server реентерабельны и могут возвратить значение DB_E_NOTREENTRANT, если потребитель пытается получить доступ к нереентерабельному методу набора строк из обратного вызова уведомления.
DBPROP_REMOVEDELETED R/W: чтение и запись

По умолчанию: VARIANT_FALSE

Описание. Драйвер OLE DB для SQL Server изменяет значение свойства на основе видимости изменений данных 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, то удаленные строки удаляются во время выборки, поэтому методы выборки строк, например GetNextRows и GetRowsAt, могут вернуть как значение S_OK, так и число строк меньше запрошенного. Это не означает, что выполняется условие DB_S_ENDOFROWSET, а также что количество строк никогда не будет равным нулю, если имеются оставшиеся строки.
DBPROP_REPORTMULTIPLECHANGES OLE DB Driver for SQL Server не реализует это свойство наборов строк. При попытке считать или записать значение свойства возникает ошибка.
DBPROP_RETURNPENDINGINSERTS R/W: только для чтения

По умолчанию: VARIANT_FALSE

Описание. При вызове метода, который извлекает строки, драйвер OLE DB для SQL Server не возвращает ожидающие вставки строки.
DBPROP_ROWRESTRICT R/W: только для чтения

По умолчанию: VARIANT_TRUE

Описание. Наборы строк OLE DB driver for SQL Server не поддерживают права доступа на основе строки. Если набор строк реализует интерфейс IRowsetChange, то потребитель может вызвать метод SetData.
DBPROP_ROWSET_ASYNCH R/W: чтение и запись

По умолчанию: 0

Описание. Предоставляет асинхронную обработку набора строк. Это свойство относится к группе свойств наборов строк и набору свойств DBPROPSET_ROWSET. и имеет тип VT_14.

Единственным значением в битовой маске, которое поддерживается OLE DB Driver for SQL Server, является DBPROPVAL_ASYNCH_INITIALIZE.
DBPROP_ROWTHREADMODEL R/W: только для чтения

По умолчанию: DBPROPVAL_RT_FREETHREAD

Описание. Драйвер OLE DB для SQL Server поддерживает доступ к своим объектам из нескольких потоков выполнения одного потребителя.
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

Описание: строгое удостоверение строки. Если набор строк допускает операции вставки (IRowsetChange или IRowsetUpdate имеют значение true), а свойство DBPROP_UPDATABILITY установлено для поддержки InsertRows, то значение DBPROP_STRONGIDENTITY зависит от свойства DBPROP_CHANGEINSERTEDROWS (VARIANT_FALSE, если свойство DBPROP_CHANGEINSERTEDROWS имеет значение VARIANT_FALSE).
DBPROP_TRANSACTEDOBJECT R/W: только для чтения

По умолчанию: VARIANT_FALSE

Описание. Драйвер OLE DB для SQL Server поддерживает только трансактированные объекты. Дополнительные сведения см. в статье о транзакциях.
DBPROP_UNIQUEROWS R/W: чтение и запись

По умолчанию: VARIANT_FALSE

Описание: уникальные строки.

VARIANT_TRUE: каждая строка определяется уникальными значениями столбца. Для набора столбцов, уникальным образом определяющих строку, в структуре DBCOLUMNINFO, возвращаемой методом GetColumnInfo, установлен флаг DBCOLUMNFLAGS_KEYCOLUMN.

VARIANT_FALSE: строки могут или не могут уникально определяться значениями своих столбцов. Ключевые столбцы могут быть либо помечены, либо не помечены флагом DBCOLUMNFLAGS_KEYCOLUMN.
DBPROP_UPDATABILITY R/W: чтение и запись

По умолчанию: 0

Описание. Драйвер OLE DB для SQL Server поддерживает все DBPROP_UPDATABILITY значения. Установка свойства DBPROP_UPDATABILITY не создает изменяемого набора строк. Чтобы сделать набор строк изменяемым, установите свойство DBPROP_IRowsetChange или DBPROP_IRowsetUpdate.

Драйвер OLE DB для SQL Server определяет зависящий от поставщика набор свойств DBPROPSET_SQLSERVERROWSET, как показано в таблице ниже.

Идентификатор свойства Description
SSPROP_COLUMN_ID Столбец: ColumnID

R/W: только для чтения

Тип: VT_U12 | VT_ARRAY

По умолчанию: VT_EMPTY

Описание. Целочисленный массив значений, представляющих порядковые номера (начиная с 1) результирующего столбца предложения COMPUTE в текущей инструкции Transact-SQL SELECT. Это эквивалент атрибута ODBC SQL_CA_SS_COLUMN_ID для OLE DB Driver for SQL Server.
SSPROP_DEFERPREPARE Столбец: Нет

R/W: чтение и запись

Тип: VT_BOOL

По умолчанию: VARIANT_TRUE

Описание. VARIANT_TRUE: при выполнении с подготовкой подготовка команды откладывается до вызова метода ICommand::Execute или выполнения операции метасвойства. Если свойство имеет значение

VARIANT_FALSE: подготовка инструкции производится при вызове метода ICommandPrepare::Prepare.
SSPROP_IRowsetFastLoad Столбец: Нет

R/W: чтение и запись

Тип: VT_BOOL

По умолчанию: VARIANT_FALSE

Описание: чтобы открыть набор строк быстрой загрузки с помощью метода IOpenRowset::OpenRowset, присвойте этому свойству значение VARIANT_TRUE. Это свойство не может быть установлено в методе ICommandProperties::SetProperties.
SSPROP_ISSAsynchStatus Столбец: Нет.

R/W: чтение и запись

Тип: VT_BOOL

По умолчанию: VARIANT_FALSE

Описание: чтобы задействовать асинхронные операции через интерфейс ISSAsynchStatus, присвойте этому свойству значение VARIANT_TRUE.
SSPROP_ISSDataClassification R/W: чтение и запись

Тип: VT_BOOL

По умолчанию: VARIANT_TRUE

Описание. Драйвер OLE DB для SQL Server поддерживает получение сведений о классификации конфиденциальности с помощью интерфейса ISSDataClassification .
SSPROP_MAXBLOBLENGTH Столбец: Нет

R/W: чтение и запись

Тип: VT_I4

По умолчанию: поставщик не ограничивает размер текста, возвращаемого сервером, и свойство имеет максимальное значение. Например, 2147483647.

Описание: для ограничения длины данных больших двоичных объектов (BLOB), возвращаемых инструкцией SELECT, драйвер OLE DB для SQL Server выполняет инструкцию SET TEXTSIZE.
SSPROP_NOCOUNT_STATUS Столбец: NoCount

R/W: только для чтения

Тип: VT_BOOL

По умолчанию: VARIANT_FALSE

Описание: логическое значение, представляющее состояние SET NOCOUNT ON/OFF в SQL Server:

VARIANT_TRUE: если SET NOCOUNT ON

VARIANT_FALSE: если SET NOCOUNT OFF
SSPROP_QP_NOTIFICATION_MSGTEXT Столбец: Нет

R/W: чтение и запись

Тип: VT_BSTR (допустимо от 1 до 2000 символов)

Значение по умолчанию: пустая строка

Описание: текст сообщения уведомления запроса. Определяется пользователем, не имеет формата определения.
SSPROP_QP_NOTIFICATION_OPTIONS Столбец: Нет

R/W: чтение и запись

Тип: VT_BSTR

Значение по умолчанию: пустая строка

Описание: параметры уведомления о запросе. Указывается в строке name=value. За создание службы и считывание уведомлений из очереди отвечает пользователь. Строка параметров уведомлений запросов имеет следующий синтаксис.

service=<service-name>[;(local database=<database>&#124;broker instance=<broker instance>)]

Например:

service=mySSBService;local database=mydb
SSPROP_QP_NOTIFICATION_TIMEOUT Столбец: Нет

R/W: чтение и запись

Тип: VT_UI4

По умолчанию: 432000 секунд (5 дней)

Минимум: 1 секунды

Максимум: 2^31-1 секунды

Описание: время в секундах, в течение которого уведомление запроса должно оставаться активным.

См. также

Наборы строк