Свойства и поведение наборов строк
Применимо: 
SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure azure Synapse Analytics Analytics Platform System (PDW)
Ниже перечислены свойства набора строк 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>|broker instance=<broker instance>)]Например: service=mySSBService;local database=mydb |
| SSPROP_QP_NOTIFICATION_TIMEOUT | Столбец: Нет R/W: чтение и запись Тип: VT_UI4 По умолчанию: 432000 секунд (5 дней) Минимум: 1 секунды Максимум: 2^31-1 секунды Описание: время в секундах, в течение которого уведомление запроса должно оставаться активным. |