Właściwości i zachowania rowsetu (natywny klient OLE DB dostawca)

Dotyczy:sql ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics

Są to właściwości rowsetu natywnego klienta OLE DB dostawcy SQL Server.

Identyfikator właściwości Opis
DBPROP_ABORTPRESERVE R/W: Odczyt/zapis

Domyślne: VARIANT_FALSE

Opis: Zachowanie zbioru wierszy po operacji przerwania jest określone przez tę właściwość.

VARIANT_FALSE: Provider natywnej bazy danych OLE DB SQL Server unieważnia wiersze po operacji przerwania. Funkcjonalność obiektu rowset jest niemal utracona. Obsługuje jedynie operacje IUnknown oraz udostępnianie nierozwiązanych uchwytów wierszowych i accessorów.

VARIANT_TRUE: Provider OLE DB SQL Server Native Client utrzymuje ważny zestaw wierszy.
DBPROP_ACCESSORDER R/W: Odczyt/zapis

Domyślny: DBPROPVAL_AO_RANDOM

Opis: Rozkaz dostępu. Kolejność, w jakiej kolumny muszą być dostępne w zestawie wierszy.

DBPROPVAL_AO_RANDOM: Kolumna jest dostępna w dowolnej kolejności.

DBPROPVAL_AO_SEQUENTIALSTORAGEOBJECTS: Kolumny powiązane jako obiekty pamięci mogą być dostępne tylko w kolejności sekwencyjnej, określonej przez kolumnowy numer porządkowy.

DBPROPVAL_AO_SEQUENTIAL: Wszystkie kolumny muszą być dostępne w kolejności sekwencyjnej, określonej przez kolumnę porządkową.
DBPROP_APPENDONLY Ta właściwość zestawu wierszy nie jest implementowana przez dostawcę natywnego klienta OLE DB SQL Server. Próba odczytu lub zapisania wartości właściwości generuje błąd.
DBPROP_BLOCKINGSTORAGEOBJECTS R/W: Tylko do czytania

Domyślne: VARIANT_TRUE

Opis: Blok obiektów pamięci masowej dla natywnego klienta OLE DB dostawcy SQL Server wykorzystujący inne metody wierszy.
DBPROP_BOOKMARKS DBPROP_LITERALBOOKMARKS R/W: Odczyt/zapis

Domyślne: VARIANT_FALSE

Opis: Provider SQL Server Native Client OLE DB obsługuje zakładki do identyfikacji wiersza zestawu, gdy DBPROP_BOOKMARKS lub DBPROP_LITERALBOOKMARKS jest VARIANT_TRUE.

Ustawienie którejkolwiek z tych właściwości na VARIANT_TRUE nie umożliwia pozycjonowania wierszy przez zakładkę. Ustaw DBPROP_IRowsetLocate lub DBPROP_IRowsetScroll na VARIANT_TRUE, aby utworzyć zestaw wierszy wspierający pozycjonowanie wierszy przez zakładkę.

Dostawca natywnego klienta OLE DB SQL Server używa kursora Microsoft SQL Server do obsługi zestawu wierszy zawierającego zakładki. Więcej informacji można znaleźć w artykule Rowsety i kursory SQL Server.

Uwaga: Ustawienie tych właściwości w konflikcie z innymi właściwościami kursora definiującymi kursor dostawcy natywnego klienta OLE DB dostawcy SQL Server powoduje błąd. Na przykład ustawienie DBPROP_BOOKMARKS na VARIANT_TRUE, gdy DBPROP_OTHERINSERT jest VARIANT_TRUE powoduje błąd, gdy konsument próbuje otworzyć zestaw wierszy.
DBPROP_BOOKMARKSKIPPED R/W: Tylko do czytania

Domyślne: VARIANT_FALSE

Opis: Dostawca SQL Server Native Client OLE DB zwraca DB_E_BADBOOKMARK, jeśli konsument wskaże nieprawidłową zakładkę podczas ustawiania lub przeszukiwania zakładkowanego wiersza.
DBPROP_BOOKMARKTYPE R/W: Tylko do czytania

Domyślne: DBPROPVAL_BMK_NUMERIC

Opis: Provider natywnej klientowej bazy danych OLE DB SQL Server implementuje wyłącznie zakładki numeryczne. Zakładka dostawcy OLE DB SQL Server Native Client to 32-bitowa bezsygnowa liczba całkowita, typ DBTYPE_UI4.
DBPROP_CACHEDEFERRED Ta właściwość zestawu wierszy nie jest implementowana przez dostawcę natywnego klienta OLE DB SQL Server. Próba odczytu lub zapisania wartości właściwości generuje błąd.
DBPROP_CANFETCHBACKWARDS DBPROP_CANSCROLLBACKWARDS R/W: Odczyt/zapis

Domyślne: VARIANT_FALSE

Opis: Provider natywnej klientowej bazy danych OLE DB SQL Server obsługuje pobieranie i przewijanie wstecznie w niesekwencyjnych zestawach wierszy. Provider natywnej bazy danych OLE DB SQL Server Native Client tworzy zestaw wierszy wspierany kursorem, gdy DBPROP_CANFETCHBACKWARDS lub DBPROP_CANSCROLLBACKWARDS jest VARIANT_TRUE. Więcej informacji można znaleźć w artykule Rowsety i kursory SQL Server.
DBPROP_CANHOLDROWS R/W: Odczyt/zapis

Domyślne: VARIANT_FALSE

Opis: Domyślnie dostawca natywnej bazy danych SQL Server klienta OLE zwraca DB_E_ROWSNOTRELEASED, jeśli konsument próbuje uzyskać więcej wierszy dla zbioru wierszów, podczas gdy oczekujące zmiany istnieją na tych aktualnie w zestawie. To zachowanie można zmienić.

Ustawienie zarówno DBPROP_CANHOLDROWS, jak i DBPROP_IRowsetChange na VARIANT_TRUE oznacza zakładkowanie zestawu wiersza. Jeśli obie właściwości są VARIANT_TRUE, interfejs IRowsetLocate jest dostępny w zestawie wierszy, a DBPROP_BOOKMARKS i DBPROP_LITERALBOOKMARKS są VARIANT_TRUE.

Wiersze dostawcy OLE DB dla natywnego klienta SQL Server, zawierające zakładki, są obsługiwane przez kursory SQL Server.
DBPROP_CHANGEINSERTEDROWS R/W: Odczyt/zapis

Domyślne: VARIANT_FALSE

Opis: Tę właściwość można ustawić na VARIANT_TRUE tylko wtedy, gdy zestaw wierszy korzysta z kursora sterowanego zestawem kluczy.
DBPROP_COLUMNRESTRICT R/W: Tylko do czytania

Domyślne: VARIANT_FALSE

Opis: Dostawca natywnego klienta OLE DB SQL Server ustawia tę właściwość na VARIANT_TRUE, gdy użytkownik nie może zmienić kolumny w zestawie wierszy. Inne kolumny w zestawie wierszy mogą być aktualizowane, a same wiersze mogą być usuwane.

Gdy własność zostanie VARIANT_TRUE, konsument analizuje członka dwFlags w strukturze DBCOLUMNINFO, aby określić, czy wartość pojedynczej kolumny można zapisać czy nie. Dla kolumn modyfikowalnych, dwFlags prezentuje DBCOLUMNFLAGS_WRITE.
DBPROP_COMMANDTIMEOUT R/W: Odczyt/zapis

Wartość domyślna: 0

Opis: Domyślnie dostawca natywnego klienta OLE DB SQL Server nie wygasa czasu na metodzie ICommand::Exekuj.
DBPROP_COMMITPRESERVE R/W: Odczyt/zapis

Domyślne: VARIANT_FALSE

Opis: Zachowanie zbioru wierszy po operacji zatwierdzenia jest determinowane przez tę właściwość.

VARIANT_TRUE: Provider OLE DB SQL Server Native Client utrzymuje ważny zestaw wierszy.

VARIANT_FALSE: Provider natywnej bazy danych OLE DB SQL Server unieważnia wiersze po operacji commit. Funkcjonalność obiektu rowset jest niemal utracona. Obsługuje jedynie operacje IUnknown oraz udostępnianie nierozwiązanych uchwytów wierszowych i accessorów.
DBPROP_DEFERRED R/W: Odczyt/zapis

Domyślne: VARIANT_FALSE

Opis: Gdy jest ustawiony VARIANT_TRUE, SQL Server natywny klient OLE DB próbuje użyć kursora serwera dla zestawu wierszów. Kolumny tekstowe, ntext i obrazy nie są zwracane z serwera, dopóki aplikacja nie uzyska do nich dostępu.
DBPROP_DELAYSTORAGEOBJECTS R/W: Tylko do czytania

Domyślne: VARIANT_FALSE

Opis: Provider natywnej klientowej bazy danych SQL Server obsługuje tryb natychmiastowej aktualizacji obiektów pamięci masowej.

Zmiany dokonane w danych w sekwencyjnym obiekcie strumieniowym są natychmiast przesyłane do SQL Server. Modyfikacje są zatwierdzane w zależności od trybu transakcji wiersza.
DBPROP_HIDDENCOLUMNS R/W: Tylko do czytania

Domyślne: VARIANT_FALSE

Opis: Ukryta liczba kolumn

Jeśli DBPROP_UNIQUEROWS jest VARIANT_TRUE, własność DBPROP_HIDDENCOLUMNS zwraca liczbę dodatkowych "ukrytych" kolumn dodanych przez dostawcę, aby jednoznacznie zidentyfikować wiersze w zestawie wierszy. Kolumny te są zwracane przez IColumnsInfo::GetColumnInfo oraz IColumnsRowset::GetColumnsRowset. Jednak nie są one uwzględniane w liczbie wierszy zwracanych przez argument pcColumns zwrócony przez IColumnsInfo::GetColumnInfo.

Aby określić łączną liczbę kolumn reprezentowanych w strukturze prgInfo zwracanej przez IColumnsInfo::GetColumnInfo, w tym ukrytych kolumn, konsument dodaje wartość DBPROP_HIDDENCOLUMNS do liczby kolumn zwróconych z IColumnsInfo::GetColumnInfo w pcColumns. Jeśli DBPROP_UNIQUEROWS jest VARIANT_FALSE, DBPROP_HIDDENCOLUMNS jest zero.
DBPROP_IAccessor DBPROP_IColumnsInfo DBPROP_IConvertType DBPROP_IRowset DBPROP_IRowsetInfo R/W: Tylko do czytania

Domyślne: VARIANT_TRUE

Opis: Provider natywnej klientowej bazy danych OLE DB SQL Server obsługuje te interfejsy we wszystkich wierszach.
DBPROP_IColumnsRowset R/W: Odczyt/zapis

Domyślne: VARIANT_TRUE

Opis: Provider natywnej klientowej bazy danych OLE DB SQL Server obsługuje interfejs IColumnsRowset.
DBPROP_IConnectionPointContainer R/W: Odczyt/zapis

Domyślne: VARIANT_FALSE

Opis: IConnectionPointContainer. Jeśli VARIANT_TRUE, zestaw wierszy obsługuje określony interfejs. Jeśli VARIANT_FALSE, zestaw wierszy nie obsługuje określonego interfejsu. Dostawcy wspierający interfejs muszą wspierać właściwość związaną z tym interfejsem o wartości VARIANT_TRUE. Właściwości te są przede wszystkim używane do żądania interfejsów za pośrednictwem ICommandProperties::SetProperties.
DBPROP_IMultipleResults R/W: Odczyt/zapis

Domyślne: VARIANT_FALSE

Opis: Dostawca natywnej bazy danych klienta SQL Server obsługuje interfejs IMultipleResults.
DBPROP_IRowsetChange DBPROP_IRowsetUpdate R/W: Odczyt/zapis

Domyślne: VARIANT_FALSE

Opis: Dostawca natywnej klientowej bazy danych OLE DB SQL Server obsługuje interfejsy IRowsetChange i IRowsetUpdate.

Zestaw wierszy utworzony przy użyciu DBPROP_IRowsetChange równego VARIANT_TRUE wykazuje natychmiastowe zachowania w trybie aktualizacji.

Gdy DBPROP_IRowsetUpdate jest VARIANT_TRUE, DBPROP_IRowsetChange też jest VARIANT_TRUE. Zestaw wierszy wykazuje opóźnione zachowanie w trybie aktualizacji.

Dostawca natywnej klientowej bazy danych OLE DB SQL Server używa kursora SQL Server do obsługi zestawów wierszy eksponujących IRowsetChange lub IRowsetUpdate. Więcej informacji można znaleźć w artykule Rowsety i kursory SQL Server.
DBPROP_IRowsetIdentity R/W: Odczyt/zapis

Domyślne: VARIANT_TRUE

Opis: Dostawca natywnej bazy danych SQL Server Client OLE obsługuje interfejs IRowsetIdentity. Jeśli zestaw wierszy obsługuje ten interfejs, dowolne dwa uchwyty wierszowe reprezentujące ten sam wiersz zawsze będą odzwierciedlać te same dane i stan. Konsumenci mogą wywołać metodę IRowsetIdentity:: IsSameRow, aby porównać dwa uchwyty wiersza i sprawdzić, czy odnoszą się do tej samej instancji wiersza.
DBPROP_IRowsetLocate DBPROP_IRowsetScroll R/W: Odczyt/zapis

Domyślne: VARIANT_FALSE

Opis: Dostawca natywnej klientowej bazy danych SQL Server może udostępniać interfejsy IRowsetLocate i IRowsetScroll.

Gdy DBPROP_IRowsetLocate jest VARIANT_TRUE, DBPROP_CANFETCHBACKWARDS i DBPROP_CANSCROLLBACKWARDS również są VARIANT_TRUE.

Gdy DBPROP_IRowsetScroll jest VARIANT_TRUE, DBPROP_IRowsetLocate również jest VARIANT_TRUE, a oba interfejsy są dostępne w rowsecie.

Zakładki są wymagane dla obu interfejsów. Dostawca SQL Server Native Client OLE DB ustawia DBPROP_BOOKMARKS i DBPROP_LITERALBOOKMARKS do VARIANT_TRUE, gdy konsument żąda któregokolwiek z interfejsów.

Dostawca natywnej klientowej bazy danych SQL Server korzysta z kursorów SQL Server do obsługi IRowsetLocate i IRowsetScroll. Więcej informacji można znaleźć w artykule Rowsety i kursory SQL Server.

Ustawienie tych właściwości w konflikcie z innymi właściwościami kursora definiującymi kursor dostawcy natywnego klienta OLE DB dostawcy SQL Server powoduje błąd. Na przykład ustawienie DBPROP_IRowsetScroll na VARIANT_TRUE, gdy DBPROP_OTHERINSERT jest VARIANT_TRUE powoduje błąd, gdy konsument próbuje otworzyć zestaw wierszy.
DBPROP_IRowsetResynch R/W: Odczyt/zapis

Domyślne: VARIANT_FALSE

Opis: Dostawca natywnej klientowej bazy danych OLE DB SQL Server udostępnia interfejs IRowsetResynch na żądanie. Provider natywnego klienta OLE DB SQL Server może udostępnić interfejs na dowolnym zestawie wierszy.
DBPROP_ISupportErrorInfo R/W: Odczyt/zapis

Domyślne: VARIANT_TRUE

Opis: Dostawca natywnej klientowej bazy danych OLE DB SQL Server udostępnia interfejs ISupportErrorInfo na wierszach.
DBPROP_ILockBytes Ten interfejs nie jest implementowany przez dostawcę bazy danych SQL Server Native Client OLE DB. Próba odczytania lub zapisu właściwości generuje błąd.
DBPROP_ISequentialStream R/W: Odczyt/zapis

Domyślne: VARIANT_FALSE

Opis: Dostawca natywnej klientowej bazy danych OLE DB SQL Server udostępnia interfejs ISequentialStream do obsługi długich, zmiennie długich danych przechowywanych w SQL Server.
DBPROP_IStorage Ten interfejs nie jest implementowany przez dostawcę bazy danych SQL Server Native Client OLE DB. Próba odczytania lub zapisu właściwości generuje błąd.
DBPROP_IStream Ten interfejs nie jest implementowany przez dostawcę bazy danych SQL Server Native Client OLE DB. Próba odczytania lub zapisu właściwości generuje błąd.
DBPROP_IMMOBILEROWS R/W: Odczyt/zapis

Domyślne: VARIANT_TRUE

Opis: Właściwość ta jest VARIANT_TRUE tylko dla kursorów zestawu kluczy SQL Server; jest VARIANT_FALSE dla wszystkich pozostałych kursorów.

VARIANT_TRUE: Zestaw wierszy nie zmieni kolejności wstawionych ani zaktualizowanych wierszy. Dla IRowsetChange::InsertRow wiersze pojawią się na końcu zbioru wierszów. Dla IRowsetChange::SetData, jeśli zbiór wierszy nie jest uporządkowany, pozycja zaktualizowanych wierszy nie ulega zmianie. Jeśli wiersz jest uporządkowany, a IRowsetChange::SetData zmienia kolumnę używaną do uporządkowania tego zbioru, wiersz nie jest przesuwany. Jeśli zestaw wierszy opiera się na zestawie kolumn klucza (zazwyczaj w zestawie wierszy, dla którego DBPROP_OTHERUPDATEDELETE jest VARIANT_TRUE, a DBPROP_OTHERINSERT VARIANT_FALSE), zmiana wartości kolumny klucza jest zazwyczaj równoznaczna z usunięciem bieżącego wiersza i wstawieniem nowego. Dlatego wiersz może wydawać się przesuwany lub nawet znikający z zestawu wierszy, jeśli DBPROP_OWNINSERT jest VARIANT_FALSE, mimo że własność DBPROP_IMMOBILEROWS jest VARIANT_TRUE.

VARIANT_FALSE: Jeśli zestaw wierszy jest uporządkowany, wstawione wiersze pojawiają się w jego właściwej kolejności. Jeśli zestaw wierszy nie jest uporządkowany, wstawiony wiersz pojawia się na końcu. Jeśli IRowsetChange::SetData zmienia kolumnę używaną do uporządkowania wiersza, wiersz jest przesuwany. Jeśli zestaw wierszy nie jest uporządkowany, pozycja wiersza nie ulega zmianie.
DBPROP_LITERALIDENTITY R/W: Tylko do czytania

Domyślne: VARIANT_TRUE

Opis: Ta nieruchomość jest zawsze VARIANT_TRUE.
DBPROP_LOCKMODE R/W: Odczyt/zapis

Domyślne: DBPROPVAL_LM_NONE

Opis: Poziom blokowania wykonywany przez zestaw wierszy (DBPROPVAL_LM_NONE, DBPROPVAL_LM_SINGLEROW).

Uwaga: Podczas stosowania izolacji snapshot w transakcji, jeśli zestaw wierszy zostanie otwarty za pomocą kursora klucza lub dynamicznego serwera, a tryb blokady jest ustawiony na DBPROPVAL_LM_SINGLEROW, pojawi się błąd przy pobieraniu wiersza, jeśli ktoś inny zaktualizował ten wiersz od momentu rozpoczęcia transakcji. W przypadku innych typów kursorów i trybów blokady, jeśli ktoś inny zaktualizował wiersz od początku transakcji, błąd pojawia się dopiero po próbie aktualizacji wiersza przez użytkownika. W obu przypadkach te błędy są generowane przez serwer.
DBPROP_MAXOPENROWS R/W: Tylko do czytania

Wartość domyślna: 0

Opis: Provider natywnej klientowej bazy danych OLE DB SQL Server nie ogranicza liczby wierszy, które mogą być aktywne w zestawach wierszy.
DBPROP_MAXPENDINGROWS R/W: Tylko do czytania

Wartość domyślna: 0

Opis: Provider natywnej klientowej bazy danych OLE DB SQL Server nie ogranicza liczby wierszy wiersza z oczekującymi zmianami.
DBPROP_MAXROWS R/W: Odczyt/zapis

Wartość domyślna: 0

Opis: Domyślnie dostawca natywnego klienta OLE DB SQL Server nie ogranicza liczby wierszy w zestawie wierszy. Gdy konsument ustawi DBPROP_MAXROWS, dostawca SQL Server Native Client OLE DB używa SET ROWCOUNT tego polecenia, aby ograniczyć liczbę wierszy w zestawie wierszy.

SET ROWCOUNTmoże powodować niezamierzone konsekwencje podczas wykonywania instrukcji SQL Server. Aby uzyskać więcej informacji, zobacz SET ROWCOUNT.
DBPROP_MAYWRITECOLUMN Ta właściwość zestawu wierszy nie jest implementowana przez dostawcę natywnego klienta OLE DB SQL Server. Próba odczytu lub zapisania wartości właściwości generuje błąd.
DBPROP_MEMORYUSAGE Ta właściwość zestawu wierszy nie jest implementowana przez dostawcę natywnego klienta OLE DB SQL Server. Próba odczytu lub zapisania wartości właściwości generuje błąd.
DBPROP_NOTIFICATIONGRANULARITY Ta właściwość zestawu wierszy nie jest implementowana przez dostawcę natywnego klienta OLE DB SQL Server. Próba odczytu lub zapisania wartości właściwości generuje błąd.
DBPROP_NOTIFICATIONPHASES R/W: Tylko do czytania

Domyślne: DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO | DBPROPVAL_NP_SYNCHAFTER | DBPROPVAL_NP_FAILEDTODO | DBPROPVAL_NP_DIDEVENT

Opis: Provider natywnego klienta OLE DB SQL Server obsługuje wszystkie fazy powiadomień.
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: Tylko do czytania

Domyślne: DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO

Opis: Fazy powiadomień dostawcy OLE DB dla natywnego klienta SQL Server można anulować przed próbą wykonania wskazanej modyfikacji zestawu wierszów. Provider natywnej klientowej bazy danych OLE DB SQL Server nie obsługuje anulowania fazy po zakończeniu próby.
DBPROP_ORDEREDBOOKMARKS Ta właściwość zestawu wierszy nie jest implementowana przez dostawcę natywnego klienta OLE DB SQL Server. Próba odczytu lub zapisania wartości właściwości generuje błąd.
DBPROP_OTHERINSERT DBPROP_OTHERUPDATEDELETE DBPROP_OWNINSERT DBPROP_OWNUPDATEDELETE R/W: Odczyt/zapis

Domyślne: VARIANT_FALSE

Opis: Ustawienie właściwości zmiany widoczności powoduje, że natywny klient OLE DB SQL Server używa kursorów SQL Server do obsługi zestawu wierszy. Więcej informacji można znaleźć w artykule Rowsety i kursory SQL Server.
DBPROP_QUICKRESTART R/W: Odczyt/zapis

Domyślne: VARIANT_FALSE

Opis: Po ustawieniu na VARIANT_TRUE, provider OLE DB SQL Server Native Client próbuje użyć kursora serwera dla zestawu wierszy.
DBPROP_REENTRANTEVENTS R/W: Tylko do czytania

Domyślne: VARIANT_TRUE

Opis: Zestawy wierszy dostawcy SQL Server Native Client OLE DB są re-entrantowane i mogą zwracać DB_E_NOTREENTRANT, jeśli konsument spróbuje uzyskać dostęp do metody niere-entrantowej z wezwania powiadomień.
DBPROP_REMOVEDELETED R/W: Odczyt/zapis

Domyślne: VARIANT_FALSE

Opis: Dostawca natywnej klientowej bazy danych OLE DB SQL Server zmienia wartość właściwości na podstawie widoczności zmian w danych SQL Server ujawnionych przez zestaw wierszy.

VARIANT_TRUE: Wiersze usunięte przez użytkownika lub innych użytkowników SQL Server są usuwane z zestawu wierszy po jego odświeżeniu. DBPROP_OTHERINSERT jest VARIANT_TRUE.

VARIANT_FALSE: Wiersze usunięte przez użytkownika lub innych użytkowników SQL Server nie są usuwane z zestawu wierszy po jego odświeżeniu. Wartość statusu wiersza usuniętych wierszy SQL Server w zestawie wierszy to DBROWSTATUS_E_DELETED. DBPROP_OTHERINSERT jest VARIANT_TRUE.

Ta właściwość ma wartość tylko dla wierszy obsługiwanych przez kursory SQL Server. Więcej informacji można znaleźć w artykule Rowsety i kursory SQL Server.

Gdy właściwość DBPROP_REMOVEDELETED jest zaimplementowana na zbiorze wierszy kursora klucza, usunięte wiersze są usuwane podczas pobierania i możliwe jest, że metody pobierania wiersza, takie jak GetNextRows i GetRowsAt, zwracają zarówno S_OK, jak i mniej wierszy niż żądano. Należy zauważyć, że to zachowanie nie oznacza DB_S_ENDOFROWSET warunku i liczba zwróconych wierszy nigdy nie będzie zerowa, jeśli pozostaną jakieś wiersze.
DBPROP_REPORTMULTIPLECHANGES Ta właściwość zestawu wierszy nie jest implementowana przez dostawcę natywnego klienta OLE DB SQL Server. Próba odczytu lub zapisania wartości właściwości generuje błąd.
DBPROP_RETURNPENDINGINSERTS R/W: Tylko do czytania

Domyślne: VARIANT_FALSE

Opis: Gdy wywołana jest metoda pobierająca wiersze, provider natywnej klientowej bazy danych SQL Server nie zwraca oczekujących wierszy wstawienia.
DBPROP_ROWRESTRICT R/W: Tylko do czytania

Domyślne: VARIANT_TRUE

Opis: Wiersze dostawcy SQL Server Native Client OLE DB nie obsługują praw dostępu opartych na tym wierszu. Jeśli interfejs IRowsetChange jest widoczny na rowsetie, użytkownik może wywołać metodę SetData .
DBPROP_ROWSET_ASYNCH R/W: Odczyt/zapis

Wartość domyślna: 0

Opis: Umożliwia asynchroniczne przetwarzanie wierszy. Ta własność należy do grupy własności Rowset oraz DBPROPSET_ROWSET zbioru właściwości. Typ jest VT_14.

Jedyną wartością w masce bitowej obsługiwanej przez SQL Server Native Client jest DBPROPVAL_ASYNCH_INITIALIZE.
DBPROP_ROWTHREADMODEL R/W: Tylko do czytania

Domyślne: DBPROPVAL_RT_FREETHREAD

Opis: Provider natywnej klientowej bazy danych OLE DB SQL Server obsługuje dostęp do swoich obiektów z wielu wątków wykonawczych jednego konsumenta.
DBPROP_SERVERCURSOR R/W: Odczyt/zapis

Domyślne: VARIANT_FALSE

Opis: Po ustawieniu używany jest kursor SQL Server do obsługi zestawu wierszy. Więcej informacji można znaleźć w artykule Rowsety i kursory SQL Server.
DBPROP_SERVERDATAONINSERT R/W: Odczyt/zapis

Domyślne: VARIANT_FALSE

Opis: Dane serwera przy wstawieniu.

VARIANT_TRUE: W momencie przesyłania insertu do serwera, dostawca pobiera dane z serwera, aby zaktualizować lokalną pamięć podręczną wiersza.

VARIANT_FALSE: Dostawca nie pobiera wartości serwera dla nowo wstawionych wierszy.
DBPROP_STRONGIDENTITY R/W: Tylko do czytania

Domyślne: VARIANT_TRUE

Opis: Tożsamość silnego rzędu. Jeśli wstawianie jest dozwolone w zestawie wierszy (prawdziwe jest IRowsetChange lub IRowsetUpdate ), a DBPROP_UPDATABILITY ustawione na obsługę InsertRows, wartość DBPROP_STRONGIDENTITY zależy od DBPROP_CHANGEINSERTEDROWS właściwości (będzie VARIANT_FALSE, jeśli wartość DBPROP_CHANGEINSERTEDROWS właściwości jest VARIANT_FALSE).
DBPROP_TRANSACTEDOBJECT R/W: Tylko do czytania

Domyślne: VARIANT_FALSE

Opis: Provider natywnej klientowej bazy danych SQL Server obsługuje tylko transakcjonowane obiekty. Aby uzyskać więcej informacji, zobacz Transakcje.
DBPROP_UNIQUEROWS R/W: Odczyt/zapis

Domyślne: VARIANT_FALSE

Opis: Unikalne rzędy.

VARIANT_TRUE: Każdy wiersz jest jednoznacznie identyfikowany przez wartości kolumn. Zestaw kolumn, które jednoznacznie identyfikują wiersz, ma zestaw DBCOLUMNFLAGS_KEYCOLUMN w strukturze DBCOLUMNINFO zwracany z metody GetColumnInfo .

VARIANT_FALSE: Wiersze mogą być jednoznacznie identyfikowane lub nie według wartości kolumn. Kolumny klucza mogą, ale nie muszą być oznaczone DBCOLUMNFLAGS_KEYCOLUMN.
DBPROP_UPDATABILITY R/W: Odczyt/zapis

Wartość domyślna: 0

Opis: Provider SQL Server Native Client OLE DB obsługuje wszystkie DBPROP_UPDATABILITY wartości. Ustawienie DBPROP_UPDATABILITY nie tworzy modyfikowalnego zestawu wierszy. Aby uczynić zestaw wierszy modyfikowalnym, ustaw DBPROP_IRowsetChange lub DBPROP_IRowsetUpdate.

Dostawca SQL Server Native Client OLE DB definiuje specyficzny dla dostawcy zestaw właściwości DBPROPSET_SQLSERVERROWSET, jak pokazano w tej tabeli.

Identyfikator właściwości Opis
SSPROP_COLUMN_ID Kolumna: ColumnID

R/W: Tylko do czytania

Typ: VT_U12 | VT_ARRAY

Domyślny: VT_EMPTY

Opis: Tablica wartości całkowito reprezentujących pozycję porządkową (opartą na 1) kolumny wyników klauzuli COMPUTE w aktualnym Transact-SQL SELECT. Jest to odpowiednik atrybutu SQL_CA_SS_COLUMN_ID ODBC SQL Server dla dostawcy OLE DB dla natywnego klienta.
SSPROP_DEFERPREPARE Kolumna: Nie

R/W: Odczyt/zapis

Typ: VT_BOOL

Domyślne: VARIANT_TRUE

Opis: VARIANT_TRUE: W przygotowanym wykonaniu przygotowanie polecenia jest odraczane do czasu wywołania ICommand::Execute lub wykonania operacji metawłaściwości. Jeśli własność jest ustawiona na

VARIANT_FALSE: Oświadczenie jest przygotowywane w momencie wykonania ICommandPrepare::P repare .
SSPROP_IRowsetFastLoad Kolumna: Nie

R/W: Odczyt/zapis

Typ: VT_BOOL

Domyślne: VARIANT_FALSE

Opis: Ustaw tę właściwość na VARIANT_TRUE, aby otworzyć szybki zestaw wierszy przez IOpenRowset::OpenRowset. Nie możesz ustawić tej właściwości w ICommandProperties::SetProperties.
SSPROP_ISSAsynchStatus Felieton: Nie.

R/W: Odczyt/zapis

Typ: VT_BOOL

Domyślne: VARIANT_FALSE

Opis: Ustaw tę właściwość na VARIANT_TRUE, aby umożliwić operacje asynchroniczne za pomocą interfejsu ISSAsynchStatus .
SSPROP_MAXBLOBLENGTH Kolumna: Nie

R/W: Odczyt/zapis

Typ: VT_I4

Domyślne: Dostawca nie ogranicza rozmiaru tekstu zwracanego przez serwer, a wartość właściwości jest ustawiona na maksymalną wartość. Na przykład 2147483647.

Opis: Provider natywnej klientowej bazy danych OLE DB SQL Server wykonuje SET TEXTSIZE polecenie ograniczające długość danych binarnych dużych obiektów (BLOB) zwracanych w instrukcji SELECT.
SSPROP_NOCOUNT_STATUS Kolumna: NoCount

R/W: Tylko do czytania

Typ: VT_BOOL

Domyślne: VARIANT_FALSE

Opis: Wartość boole'a reprezentująca status SET NOCOUNT ON/OFF w SQL Server:

VARIANT_TRUE: gdy SET NOCOUNT WŁĄCZONE

VARIANT_FALSE: gdy SET NOCOUNT WYŁĄCZONE
SSPROP_QP_NOTIFICATION_MSGTEXT Kolumna: Nie

R/W: Odczyt/zapis

Typ: VT_BSTR (dozwolone 1-2000 znaków)

Domyślne: Pusty ciąg

Opis: Tekst wiadomości powiadomienia zapytania. Jest to zdefiniowane przez użytkownika i nie ma określonego formatu.
SSPROP_QP_NOTIFICATION_OPTIONS Kolumna: Nie

R/W: Odczyt/zapis

Typ: VT_BSTR

Domyślne: Pusty ciąg

Opis: Opcje powiadomień zapytania. Są one określone w ciągu z name=value. Użytkownik jest odpowiedzialny za tworzenie usługi i odczytywanie powiadomień poza kolejką. Składnia ciągu opcji powiadomień zapytania to:

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

Przykład:

service=mySSBService;local database=mydb
SSPROP_QP_NOTIFICATION_TIMEOUT Kolumna: Nie

R/W: Odczyt/zapis

Typ: VT_UI4

Domyślne: 432000 sekund (5 dni)

Minimum: 1 sekunda

Maksymalnie: 2^31-1 sekunda

Opis: Liczba sekund, przez które powiadomienie zapytania pozostaje aktywne.