Свойства и поведение наборов строк
Это SQL Server Native Client свойств набора строк поставщика OLE DB.
| Идентификатор свойства | Описание |
|---|---|
| DBPROP_ABORTPRESERVE | Ч/З Чтение/запись Значение по умолчанию: VARIANT_FALSE Описание. Этим свойством определяется поведение набора строк после аварийного завершения операции. VARIANT_FALSE. Поставщик OLE DB SQL Server Native Client делает наборы строк недействительными после операции прерывания. Объект набора строк практически утратил свою функциональность. Он поддерживает только операции IUnknown, а также освобождение необработанных строк и обработчики методов доступа. VARIANT_TRUE. Поставщик OLE DB SQL Server Native Client поддерживает допустимый набор строк. |
| DBPROP_ACCESSORDER | Ч/З Чтение/запись Значение по умолчанию: DBPROPVAL_AO_RANDOM Описание. Порядок доступа. Порядок, в котором должен осуществляться доступ к столбцам в наборе строк. DBPROPVAL_AO_RANDOM: доступ к столбцам можно осуществлять в любом порядке. DBPROPVAL_AO_SEQUENTIALSTORAGEOBJECTS: доступ к столбцам как к связанным объектам хранилища можно осуществлять только последовательно (по порядковому номеру столбца). DBPROPVAL_AO_SEQUENTIAL: доступ ко всем столбцам должен осуществляться последовательно (по порядковому номеру столбца). |
| DBPROP_APPENDONLY | Это свойство набора строк не реализуется поставщиком SQL SERVER NATIVE CLIENT OLE DB. При попытке считать или записать значение свойства возникает ошибка. |
| DBPROP_BLOCKINGSTORAGEOBJECTS | Ч/З Только для чтения Значение по умолчанию: VARIANT_TRUE Описание: SQL Server Native Client блок объектов хранилища поставщика OLE DB с помощью других методов набора строк. |
| DBPROP_BOOKMARKS DBPROP_LITERALBOOKMARKS | Ч/З Чтение/запись Значение по умолчанию: 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 использует курсор microsoft SQL Server для поддержки набора строк, содержащего закладки. Дополнительные сведения см. в статье Наборы строк и курсоры SQL Server. Примечание: Задание этих свойств в конфликте с другими SQL Server Native Client свойств, определяющих курсор поставщика OLE DB, приводит к ошибке. Например, при попытке потребителя открыть набор строк, свойства DBPROP_BOOKMARKS и DBPROP_OTHERINSERT которого имеют значение VARIANT_TRUE, будет выдана ошибка. |
| DBPROP_BOOKMARKSKIPPED | Ч/З Только для чтения Значение по умолчанию: VARIANT_FALSE Описание. Поставщик SQL SERVER NATIVE CLIENT OLE DB возвращает DB_E_BADBOOKMARK, если потребитель указывает на недопустимую закладку при расположении или поиске набора строк с закладками. |
| DBPROP_BOOKMARKTYPE | Ч/З Только для чтения Значение по умолчанию: DBPROPVAL_BMK_NUMERIC Описание. Поставщик OLE DB SQL Server Native Client реализует только числовые закладки. Закладка поставщика SQL Server Native Client OLE DB — это 32-разрядное целое число без знака, введите DBTYPE_UI4. |
| DBPROP_CACHEDEFERRED | Это свойство набора строк не реализуется поставщиком SQL SERVER NATIVE CLIENT OLE DB. При попытке считать или записать значение свойства возникает ошибка. |
| DBPROP_CANFETCHBACKWARDS DBPROP_CANSCROLLBACKWARDS | Ч/З Чтение/запись Значение по умолчанию: VARIANT_FALSE Описание. Поставщик OLE DB SQL Server Native Client поддерживает обратную выборку и прокрутку в несезначных наборах строк. Поставщик OLE DB SQL Server Native Client создает набор строк, поддерживаемый курсором, если VARIANT_TRUE DBPROP_CANFETCHBACKWARDS или DBPROP_CANSCROLLBACKWARDS. Дополнительные сведения см. в статье Наборы строк и курсоры SQL Server. |
| DBPROP_CANHOLDROWS | Ч/З Чтение/запись Значение по умолчанию: VARIANT_FALSE Описание. По умолчанию поставщик OLE DB SQL Server Native Client возвращает DB_E_ROWSNOTRELEASED, если потребитель пытается получить больше строк для набора строк, пока в наборе строк существуют ожидающие изменения. Это поведение может быть изменено. Присвоение свойствам DBPROP_CANHOLDROWS и DBPROP_IRowsetChange значения VARIANT_TRUE подразумевает набор строк с закладками. Если оба свойства имеют значение VARIANT_TRUE, то для набора строк доступен интерфейс IRowsetLocate, а свойства DBPROP_BOOKMARKS и DBPROP_LITERALBOOKMARKS имеют значение VARIANT_TRUE. SQL Server Native Client наборы строк поставщика OLE DB, содержащие закладки, поддерживаются курсорами SQL Server. |
| DBPROP_CHANGEINSERTEDROWS | Ч/З Чтение/запись Значение по умолчанию: VARIANT_FALSE Описание. Это свойство может иметь только значение VARIANT_TRUE, если набор строк использует курсор, управляемый набором ключей. |
| DBPROP_COLUMNRESTRICT | Ч/З Только для чтения Значение по умолчанию: VARIANT_FALSE Описание. Поставщик OLE DB SQL Server Native Client задает свойству значение VARIANT_TRUE, когда столбец в наборе строк не может быть изменен потребителем. Другие столбцы в наборе строк можно изменять, а сами строки — удалять. Если это свойство имеет значение VARIANT_TRUE, то потребитель по элементу dwFlags структуры DBCOLUMNINFO определяет, может ли быть записано значение отдельного столбца. Для изменяемых столбцов элемент dwFlags принимает значение DBCOLUMNFLAGS_WRITE. |
| DBPROP_COMMANDTIMEOUT | Ч/З Чтение/запись Значение по умолчанию: 0 Описание. По умолчанию SQL Server Native Client поставщика OLE DB не истекает время ожидания для метода ICommand::Execute. |
| DBPROP_COMMITPRESERVE | Ч/З Чтение/запись Значение по умолчанию: VARIANT_FALSE Описание. Это свойство определяет поведение набора строк после выполнения фиксации. VARIANT_TRUE. Поставщик OLE DB SQL Server Native Client поддерживает допустимый набор строк. VARIANT_FALSE. Поставщик OLE DB SQL Server Native Client делает наборы строк недействительными после операции фиксации. Объект набора строк практически утратил свою функциональность. Он поддерживает только операции IUnknown, а также освобождение необработанных строк и обработчики методов доступа. |
| DBPROP_DEFERRED | Ч/З Чтение/запись Значение по умолчанию: VARIANT_FALSE Описание. Если задано значение VARIANT_TRUE поставщик SQL Server Native Client OLE DB пытается использовать серверный курсор для набора строк. Столбцы типа text, ntext и image не возвращаются с сервера до тех пор, пока приложение не обратится к ним. |
| DBPROP_DELAYSTORAGEOBJECTS | Ч/З Только для чтения Значение по умолчанию: VARIANT_FALSE Описание. Поставщик OLE DB SQL Server Native Client поддерживает режим немедленного обновления для объектов хранилища. Изменения, примененные к данным в объекте последовательного потока, немедленно передаются SQL Server. Фиксация изменений производится в соответствии с режимом транзакций набора строк. |
| DBPROP_HIDDENCOLUMNS | Ч/З Только для чтения Значение по умолчанию: 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 | Ч/З Только для чтения Значение по умолчанию: VARIANT_TRUE Описание. Поставщик OLE DB SQL Server Native Client поддерживает эти интерфейсы во всех наборах строк. |
| DBPROP_IColumnsRowset | Ч/З Чтение/запись Значение по умолчанию: VARIANT_TRUE Описание. Поставщик OLE DB SQL Server Native Client поддерживает интерфейс IColumnsRowset. |
| DBPROP_IConnectionPointContainer | Ч/З Чтение/запись Значение по умолчанию: VARIANT_FALSE Описание. IConnectionPointContainer. Если значение равно VARIANT_TRUE, то набор строк поддерживает заданный интерфейс. Если значение равно VARIANT_FALSE, то набор строк не поддерживает заданный интерфейс. Поставщики, поддерживающие тот или иной интерфейс, должны поддерживать связанное с этим интерфейсом свойство, которое возвращает значение VARIANT_TRUE. Эти свойства служат главным образом для запроса интерфейсов с помощью метода ICommandProperties::SetProperties. |
| DBPROP_IMultipleResults | Ч/З Чтение/запись Значение по умолчанию: VARIANT_FALSE Описание. Поставщик OLE DB SQL Server Native Client поддерживает интерфейс IMultipleResults. |
| DBPROP_IRowsetChange DBPROP_IRowsetUpdate | Ч/З Чтение/запись Значение по умолчанию: VARIANT_FALSE Описание. Поставщик OLE DB SQL Server Native Client поддерживает интерфейсы IRowsetChange и IRowsetUpdate. Набор строк, созданный с DBPROP_IRowsetChange, равным VARIANT_TRUE, отражает режимы немедленного обновления. Если DBPROP_IRowsetUpdate имеет значение VARIANT_TRUE, то DBPROP_IRowsetChange также имеет значение VARIANT_TRUE. Набор строк характеризуется поведением отложенного обновления. Поставщик SQL Server Native Client OLE DB использует курсор SQL Server для поддержки наборов строк, предоставляющих IRowsetChange или IRowsetUpdate. Дополнительные сведения см. в статье Наборы строк и курсоры SQL Server. |
| DBPROP_IRowsetIdentity | Ч/З Чтение/запись Значение по умолчанию: VARIANT_TRUE Описание. Поставщик OLE DB SQL Server Native Client поддерживает интерфейс IRowsetIdentity. Если набор строк поддерживает этот интерфейс, то любые два дескриптора строк, относящихся к одной базовой строке, всегда представляют одни и те же данные и состояние. Объекты-получатели могут вызвать метод IRowsetIdentity:: IsSameRow, чтобы сравнить два дескриптора строки и проверить, относятся ли они к одному и тому же экземпляру строки. |
| DBPROP_IRowsetLocate DBPROP_IRowsetScroll | Ч/З Чтение/запись Значение по умолчанию: VARIANT_FALSE Описание. Поставщик SQL Server Native Client OLE DB может предоставлять интерфейсы IRowsetLocate и IRowsetScroll. Если DBPROP_IRowsetLocate имеет значение VARIANT_TRUE, 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 курсоры для поддержки IRowsetLocate и IRowsetScroll. Дополнительные сведения см. в статье Наборы строк и курсоры SQL Server. Задание этих свойств в конфликте с другими SQL Server Native Client свойств, определяющих курсор поставщика OLE DB, приводит к ошибке. Например, при попытке потребителя открыть набор строк, свойства DBPROP_IRowsetScroll и DBPROP_OTHERINSERT которого имеют значение VARIANT_TRUE, будет выдана ошибка. |
| DBPROP_IRowsetResynch | Ч/З Чтение/запись Значение по умолчанию: VARIANT_FALSE Описание. Поставщик SQL SERVER NATIVE CLIENT OLE DB предоставляет интерфейс IRowsetResynch по запросу. Поставщик OLE DB SQL Server Native Client может предоставлять интерфейс для любого набора строк. |
| DBPROP_ISupportErrorInfo | Ч/З Чтение/запись Значение по умолчанию: VARIANT_TRUE Описание. Поставщик OLE DB SQL Server Native Client предоставляет интерфейс ISupportErrorInfo для наборов строк. |
| DBPROP_ILockBytes | Этот интерфейс не реализуется поставщиком SQL SERVER NATIVE CLIENT OLE DB. При попытке считать или записать свойство возникает ошибка. |
| DBPROP_ISequentialStream | Ч/З Чтение/запись Значение по умолчанию: VARIANT_FALSE Описание. Поставщик OLE DB SQL Server Native Client предоставляет интерфейс ISequentialStream для поддержки длинных данных переменной длины, хранящихся в SQL Server. |
| DBPROP_IStorage | Этот интерфейс не реализуется поставщиком SQL SERVER NATIVE CLIENT OLE DB. При попытке считать или записать свойство возникает ошибка. |
| DBPROP_IStream | Этот интерфейс не реализуется поставщиком SQL SERVER NATIVE CLIENT OLE DB. При попытке считать или записать свойство возникает ошибка. |
| DBPROP_IMMOBILEROWS | Ч/З Чтение/запись Значение по умолчанию: 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 | Ч/З Только для чтения Значение по умолчанию: VARIANT_TRUE Описание. Значение этого свойства всегда равно VARIANT_TRUE. |
| DBPROP_LOCKMODE | Ч/З Чтение/запись Значение по умолчанию: DBPROPVAL_LM_NONE Описание. Уровень блокировки, выполняемый набором строк (DBPROPVAL_LM_NONE, DBPROPVAL_LM_SINGLEROW). Примечание: При использовании изоляции snapshot в транзакции, если набор строк открывается с помощью набора ключей или динамического серверного курсора и режим блокировки имеет значение DBPROPVAL_LM_SINGLEROW, при выборке строки возникнет ошибка, если кто-то другой обновил строку с момента начала транзакции. Для других типов курсоров и режимов блокировки, если другой пользователь обновил строку со времени начала транзакции, то ошибка не произойдет до тех пор, пока пользователь не попытается обновить эту строку. В обоих случаях ошибка будет сформирована сервером. |
| DBPROP_MAXOPENROWS | Ч/З Только для чтения Значение по умолчанию: 0 Описание. Поставщик SQL Server Native Client OLE DB не ограничивает количество строк, которые могут быть активны в наборах строк. |
| DBPROP_MAXPENDINGROWS | Ч/З Только для чтения Значение по умолчанию: 0 Описание. Поставщик SQL Server Native Client OLE DB не ограничивает количество строк набора строк с ожидающих изменений. |
| DBPROP_MAXROWS | Ч/З Чтение/запись Значение по умолчанию: 0 Описание. По умолчанию поставщик SQL Server Native Client OLE DB не ограничивает количество строк в наборе строк. Когда потребитель задает DBPROP_MAXROWS, поставщик SQL SERVER NATIVE CLIENT OLE DB использует инструкцию 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 | Ч/З Только для чтения По умолчанию: 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 | Ч/З Только для чтения По умолчанию: 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 | Ч/З Чтение/запись Значение по умолчанию: VARIANT_FALSE Описание. Установка свойств видимости изменений приводит к тому, что поставщик SQL SERVER NATIVE CLIENT OLE DB будет использовать SQL Server курсоры для поддержки набора строк. Дополнительные сведения см. в статье Наборы строк и курсоры SQL Server. |
| DBPROP_QUICKRESTART | Ч/З Чтение/запись Значение по умолчанию: VARIANT_FALSE Описание. Если задано значение VARIANT_TRUE, поставщик OLE DB SQL Server Native Client пытается использовать серверный курсор для набора строк. |
| DBPROP_REENTRANTEVENTS | Ч/З Только для чтения Значение по умолчанию: VARIANT_TRUE Описание. Наборы строк поставщика SQL SERVER NATIVE CLIENT OLE DB повторно входят и могут возвращать DB_E_NOTREENTRANT, если потребитель пытается получить доступ к методу набора строк, не являющегося участником, из обратного вызова уведомления. |
| DBPROP_REMOVEDELETED | Ч/З Чтение/запись Значение по умолчанию: 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, то удаленные строки удаляются во время выборки, поэтому методы выборки строк, например GetNextRows и GetRowsAt, могут вернуть как значение S_OK, так и число строк меньше запрошенного. Это не означает, что выполняется условие DB_S_ENDOFROWSET, а также что количество строк никогда не будет равным нулю, если имеются оставшиеся строки. |
| DBPROP_REPORTMULTIPLECHANGES | Это свойство набора строк не реализуется поставщиком SQL SERVER NATIVE CLIENT OLE DB. При попытке считать или записать значение свойства возникает ошибка. |
| DBPROP_RETURNPENDINGINSERTS | Ч/З Только для чтения Значение по умолчанию: VARIANT_FALSE Описание. При вызове метода, который извлекает строки, поставщик SQL Server Native Client OLE DB не возвращает ожидающие вставки строки. |
| DBPROP_ROWRESTRICT | Ч/З Только для чтения Значение по умолчанию: VARIANT_TRUE Описание: SQL Server Native Client наборы строк поставщика OLE DB не поддерживают права доступа на основе строки. Если набор строк реализует интерфейс IRowsetChange, то потребитель может вызвать метод SetData. |
| DBPROP_ROWSET_ASYNCH | Ч/З Чтение/запись Значение по умолчанию: 0 Описание: обеспечивает асинхронную обработку набора строк. Это свойство относится к группе свойств наборов строк и набору свойств DBPROPSET_ROWSET. и имеет тип VT_14. Единственное значение в битовой маске, поддерживаемой SQL Server Native Client, — . DBPROPVAL_ASYNCH_INITIALIZE |
| DBPROP_ROWTHREADMODEL | Ч/З Только для чтения Значение по умолчанию: DBPROPVAL_RT_FREETHREAD Описание. Поставщик SQL SERVER NATIVE CLIENT OLE DB поддерживает доступ к своим объектам из нескольких потоков выполнения одного потребителя. |
| DBPROP_SERVERCURSOR | Ч/З Чтение/запись Значение по умолчанию: VARIANT_FALSE Описание. Если установлено, то для поддержки набора строк используется курсор SQL Server. Дополнительные сведения см. в статье Наборы строк и курсоры SQL Server. |
| DBPROP_SERVERDATAONINSERT | Ч/З Чтение/запись Значение по умолчанию: VARIANT_FALSE Описание. Данные сервера при вставке. VARIANT_TRUE: при передаче операции вставки на сервер поставщик получает данные с сервера для обновления локального кэша строк. VARIANT_FALSE: поставщик не получает с сервера значения для только что вставленных строк. |
| DBPROP_STRONGIDENTITY | Ч/З Только для чтения Значение по умолчанию: VARIANT_TRUE Описание. Строгий идентификатор строки. Если набор строк допускает операции вставки (IRowsetChange или IRowsetUpdate имеют значение true), а свойство DBPROP_UPDATABILITY установлено для поддержки InsertRows, то значение DBPROP_STRONGIDENTITY зависит от свойства DBPROP_CHANGEINSERTEDROWS (VARIANT_FALSE, если свойство DBPROP_CHANGEINSERTEDROWS имеет значение VARIANT_FALSE). |
| DBPROP_TRANSACTEDOBJECT | Ч/З Только для чтения Значение по умолчанию: VARIANT_FALSE Описание. Поставщик SQL SERVER NATIVE CLIENT OLE DB поддерживает только объекты, с транзакцией. Дополнительные сведения см. в статье о транзакциях. |
| DBPROP_UNIQUEROWS | Ч/З Чтение/запись Значение по умолчанию: VARIANT_FALSE Описание. Уникальные строки. VARIANT_TRUE: каждая строка определяется уникальными значениями столбца. Для набора столбцов, уникальным образом определяющих строку, в структуре DBCOLUMNINFO, возвращаемой методом GetColumnInfo, установлен флаг DBCOLUMNFLAGS_KEYCOLUMN. VARIANT_FALSE: строки могут или не могут уникально определяться значениями своих столбцов. Ключевые столбцы могут быть либо помечены, либо не помечены флагом DBCOLUMNFLAGS_KEYCOLUMN. |
| DBPROP_UPDATABILITY | Ч/З Чтение/запись Значение по умолчанию: 0 Описание. Поставщик OLE DB SQL Server Native Client поддерживает все DBPROP_UPDATABILITY значения. Установка свойства DBPROP_UPDATABILITY не создает изменяемого набора строк. Чтобы сделать набор строк изменяемым, установите свойство DBPROP_IRowsetChange или DBPROP_IRowsetUpdate. |
Поставщик OLE DB SQL Server Native Client определяет набор свойств конкретного поставщика DBPROPSET_SQLSERVERROWSET, как показано в этой таблице.
| Идентификатор свойства | Описание |
|---|---|
| SSPROP_COLUMN_ID | Столбец: ColumnID Ч/З Только для чтения Тип: VT_U12 | VT_ARRAY Значение по умолчанию: VT_EMPTY Описание. Целочисленный массив значений, представляющих порядковые номера (начиная с 1) результирующего столбца предложения COMPUTE в текущей инструкции Transact-SQL SELECT. Это SQL Server Native Client поставщик OLE DB, эквивалентный атрибуту SQL_CA_SS_COLUMN_ID ODBC. |
| SSPROP_DEFERPREPARE | Столбец: нет Ч/З Чтение/запись Тип: VT_BOOL. Значение по умолчанию: VARIANT_TRUE Описание. VARIANT_TRUE: при выполнении с подготовкой команда подготовки откладывается до вызова метода ICommand::Execute или выполнения операции метасвойства. Если свойство имеет значение VARIANT_FALSE: подготовка инструкции производится при вызове метода ICommandPrepare::Prepare. |
| SSPROP_IRowsetFastLoad | Столбец: нет Ч/З Чтение/запись Тип: VT_BOOL. Значение по умолчанию: VARIANT_FALSE Описание. Чтобы открыть набор строк быстрой загрузки с помощью метода IOpenRowset::OpenRowset, присвойте этому свойству значение VARIANT_TRUE. Это свойство не может быть установлено в методе ICommandProperties::SetProperties. |
| SSPROP_ISSAsynchStatus | Столбец: Нет. Ч/З Чтение/запись Тип: VT_BOOL. Значение по умолчанию: VARIANT_FALSE Описание. Чтобы задействовать асинхронные операции через интерфейс ISSAsynchStatus, присвойте этому свойству значение VARIANT_TRUE. |
| SSPROP_MAXBLOBLENGTH | Столбец: нет Ч/З Чтение/запись Тип: VT_I4 Значение по умолчанию: поставщик не ограничивает размер текста, возвращаемого сервером, и это свойство определяет это максимальное значение. Например, 2147483647. Описание. Поставщик OLE DB SQL Server Native Client выполняет инструкцию SET TEXTSIZE, чтобы ограничить длину данных больших двоичных объектов (BLOB), возвращаемых в инструкции SELECT. |
| SSPROP_NOCOUNT_STATUS | Столбец: NoCount. Ч/З Только для чтения Тип: VT_BOOL. Значение по умолчанию: VARIANT_FALSE Описание. Логическое значение, представляющее состояние SET NOCOUNT ON/OFF в SQL Server: VARIANT_TRUE: если SET NOCOUNT ON VARIANT_FALSE: если SET NOCOUNT OFF |
| SSPROP_QP_NOTIFICATION_MSGTEXT | Столбец: нет Ч/З Чтение/запись Тип: VT_BSTR (допустимо от 1 до 2000 символов). Значение по умолчанию: Пустая строка. Описание. Текст сообщения уведомления запроса. Определяется пользователем, не имеет формата определения. |
| SSPROP_QP_NOTIFICATION_OPTIONS | Столбец: нет Ч/З Чтение/запись Тип: VT_BSTR Значение по умолчанию: Пустая строка. Описание. параметры уведомлений о запросах. Указывается в строке name=value. За создание службы и считывание уведомлений из очереди отвечает пользователь. Строка параметров уведомлений запросов имеет следующий синтаксис.service=<service-name>[;(local database=<database>|broker instance=<broker instance>)]Пример: service=mySSBService;local database=mydb |
| SSPROP_QP_NOTIFICATION_TIMEOUT | Столбец: нет Ч/З Чтение/запись Тип: VT_UI4 Значение по умолчанию: 432 000 секунд (5 дней). Минимальные: 1 секунда. Максимальное значение: 2^31–1 секунд. Описание. время в секундах, в течение которого уведомление запроса должно оставаться активным. |