Eigenschaften und Verhaltensweisen von Rowsets
Dies sind die SQL Server Native Client OLE DB-Anbieterrowseteigenschaften.
| Eigenschafts-ID | BESCHREIBUNG |
|---|---|
| DBPROP_ABORTPRESERVE | R/W: Lesen/Schreiben Standardwert: VARIANT_FALSE Beschreibung: Das Verhalten eines Rowsets, nachdem ein Abbruchvorgang von dieser Eigenschaft bestimmt wurde. VARIANT_FALSE: Der SQL Server Native Client OLE DB-Anbieter ungültige Rowsets nach einem Abbruchvorgang. Die Funktionalität des Rowsetobjekts ist beinahe verloren. Es werden nur IUnknown-Vorgänge und die Freigabe ausstehender Zeilen- und Accessorhandles unterstützt. VARIANT_TRUE: Der SQL Server Native Client OLE DB-Anbieter verwaltet ein gültiges Rowset. |
| DBPROP_ACCESSORDER | R/W: Lesen/Schreiben Standardwert: DBPROPVAL_AO_RANDOM Beschreibung: Reihenfolge des Zugriffs. Die Reihenfolge, in der auf die Spalten im Rowset zugegriffen werden muss. DBPROPVAL_AO_RANDOM: Auf die Spalte kann in beliebiger Reihenfolge zugegriffen werden. DBPROPVAL_AO_SEQUENTIALSTORAGEOBJECTS: Auf als Speicherobjekte gebundene Spalten kann nur in einer sequenziellen, von der Spaltenordnungszahl bestimmten Reihenfolge zugegriffen werden. DBPROPVAL_AO_SEQUENTIAL: Auf alle Spalten muss in einer sequenziellen, von der Spaltenordnungszahl bestimmten Reihenfolge zugegriffen werden. |
| DBPROP_APPENDONLY | Diese Rowseteigenschaft wird nicht vom SQL Server Native Client OLE DB-Anbieter implementiert. Beim Versuch, den Eigenschaftswert zu lesen oder zu schreiben, wird ein Fehler generiert. |
| DBPROP_BLOCKINGSTORAGEOBJECTS | R/W: Schreibgeschützt Standardwert: VARIANT_TRUE Beschreibung: Der SQL Server Native Client OLE DB-Anbieterspeicherobjekte mit anderen Rowsetmethoden. |
| DBPROP_BOOKMARKS DBPROP_LITERALBOOKMARKS | R/W: Lesen/Schreiben Standardwert: VARIANT_FALSE Beschreibung: Der SQL Server Native Client OLE DB-Anbieter unterstützt Lesezeichen für die Rowsetzeilenidentifikation, wenn DBPROP_BOOKMARKS oder DBPROP_LITERALBOOKMARKS VARIANT_TRUE ist. Das Festlegen einer der beiden Eigenschaft auf VARIANT_TRUE aktiviert keine Rowsetpositionierung durch Lesezeichen. Legen Sie DBPROP_IRowsetLocate oder DBPROP_IRowsetScroll auf VARIANT_TRUE fest, um ein Rowset zu erstellen, das die Rowsetpositionierung durch Lesezeichen unterstützt. Der SQL Server Native Client OLE DB-Anbieter verwendet einen Microsoft SQL Server-Cursor, um ein Rowset zu unterstützen, das Lesezeichen enthält. Weitere Informationen finden Sie unter Rowsets und SQL Server-Cursor. Hinweis: Das Festlegen dieser Eigenschaften in Konflikt mit anderen SQL Server Native Client Cursordefinitionseigenschaften des OLE DB-Anbieters verursacht einen Fehler. Falls Sie beispielsweise DBPROP_BOOKMARKS auf VARIANT_TRUE festlegen, wenn DBPROP_OTHERINSERT ebenfalls den Wert VARIANT_TRUE aufweist, tritt ein Fehler auf, wenn der Consumer versucht, ein Rowset zu öffnen. |
| DBPROP_BOOKMARKSKIPPED | R/W: Schreibgeschützt Standardwert: VARIANT_FALSE Beschreibung: Der SQL Server Native Client OLE DB-Anbieter gibt DB_E_BADBOOKMARK zurück, wenn der Consumer beim Positionieren oder Durchsuchen eines Mit Lesezeichen versehenen Rowsets ein ungültiges Lesezeichen angibt. |
| DBPROP_BOOKMARKTYPE | R/W: Schreibgeschützt Standardwert: DBPROPVAL_BMK_NUMERIC Beschreibung: Der SQL Server Native Client OLE DB-Anbieter implementiert nur numerische Lesezeichen. Ein SQL Server Native Client LESEZEICHEN des OLE DB-Anbieters ist eine 32-Bit-Ganzzahl ohne Vorzeichen, geben Sie DBTYPE_UI4 ein. |
| DBPROP_CACHEDEFERRED | Diese Rowseteigenschaft wird nicht vom SQL Server Native Client OLE DB-Anbieter implementiert. Beim Versuch, den Eigenschaftswert zu lesen oder zu schreiben, wird ein Fehler generiert. |
| DBPROP_CANFETCHBACKWARDS DBPROP_CANSCROLLBACKWARDS | R/W: Lesen/Schreiben Standardwert: VARIANT_FALSE Beschreibung: Der SQL Server Native Client OLE DB-Anbieter unterstützt das Rückwärtsabrufen und Scrollen in nicht ausquenten Rowsets. Der SQL Server Native Client OLE DB-Anbieter erstellt ein cursorgestütztes Rowset, wenn entweder DBPROP_CANFETCHBACKWARDS oder DBPROP_CANSCROLLBACKWARDS VARIANT_TRUE ist. Weitere Informationen finden Sie unter Rowsets und SQL Server-Cursor. |
| DBPROP_CANHOLDROWS | R/W: Lesen/Schreiben Standardwert: VARIANT_FALSE Beschreibung: Standardmäßig gibt der SQL Server Native Client OLE DB-Anbieter DB_E_ROWSNOTRELEASED zurück, wenn der Consumer versucht, mehr Zeilen für ein Rowset abzurufen, während an den derzeit im Rowset ausstehenden Änderungen vorhanden sind. Dieses Verhalten kann geändert werden. Das Festlegen von DBPROP_CANHOLDROWS und DBPROP_IRowsetChange auf VARIANT_TRUE impliziert ein mit Lesezeichen versehenes Rowset. Wenn beide Eigenschaften auf VARIANT_TRUE festgelegt sind, ist die IRowsetLocate-Schnittstelle für das Rowset verfügbar, und sowohl DBPROP_BOOKMARKS als auch DBPROP_LITERALBOOKMARKS weisen den Wert VARIANT_TRUE auf. SQL Server Native Client OLE DB-Anbieterrowsets, die Lesezeichen enthalten, werden von SQL Server Cursorn unterstützt. |
| DBPROP_CHANGEINSERTEDROWS | R/W: Lesen/Schreiben Standardwert: VARIANT_FALSE Beschreibung: Diese Eigenschaft kann nur auf VARIANT_TRUE festgelegt werden, wenn das Rowset einen über einen keysetgesteuerten Cursor verwendet. |
| DBPROP_COLUMNRESTRICT | R/W: Schreibgeschützt Standardwert: VARIANT_FALSE Beschreibung: Der SQL Server Native Client OLE DB-Anbieter legt die Eigenschaft auf VARIANT_TRUE fest, wenn eine Spalte in einem Rowset vom Consumer nicht geändert werden kann. Andere Spalten im Rowset können möglicherweise aktualisiert werden, und die Zeilen selbst können gelöscht werden. Wenn die Eigenschaft auf VARIANT_TRUE festgelegt ist, überprüft der Consumer das dwFlags-Element der DBCOLUMNINFO-Struktur, um zu bestimmen, ob der Wert einer einzelnen Spalte geschrieben werden kann oder nicht. Für veränderbare Spalten weist dwFlags DBCOLUMNFLAGS_WRITE auf. |
| DBPROP_COMMANDTIMEOUT | R/W: Lesen/Schreiben Standardwert: 0 Beschreibung: Standardmäßig tritt für den SQL Server Native Client OLE DB-Anbieter für die ICommand::Execute-Methode kein Timeout auf. |
| DBPROP_COMMITPRESERVE | R/W: Lesen/Schreiben Standardwert: VARIANT_FALSE Beschreibung: Das Verhalten eines Rowsets, nachdem ein Commitvorgang von dieser Eigenschaft bestimmt wurde. VARIANT_TRUE: Der SQL Server Native Client OLE DB-Anbieter verwaltet ein gültiges Rowset. VARIANT_FALSE: Der SQL Server Native Client OLE DB-Anbieter ungültige Rowsets nach einem Commitvorgang. Die Funktionalität des Rowsetobjekts ist beinahe verloren. Es werden nur IUnknown-Vorgänge und die Freigabe ausstehender Zeilen- und Accessorhandles unterstützt. |
| DBPROP_DEFERRED | R/W: Lesen/Schreiben Standardwert: VARIANT_FALSE Beschreibung: Bei Festlegung auf VARIANT_TRUE versucht der SQL Server Native Client OLE DB-Anbieter, einen Servercursor für das Rowset zu verwenden. Die Spalten Text, ntext und image werden erst vom Server zurückgegeben, wenn die Anwendung auf sie zugreift. |
| DBPROP_DELAYSTORAGEOBJECTS | R/W: Schreibgeschützt Standardwert: VARIANT_FALSE Beschreibung: Der SQL Server Native Client OLE DB-Anbieter unterstützt den sofortigen Updatemodus für Speicherobjekte. An Daten in einem sequenziellen Datenstromobjekt vorgenommene Änderungen werden sofort an SQL Server gesendet. Ein Commit für Änderungen wird auf Grundlage des Rowsettransaktionsmodus ausgeführt. |
| DBPROP_HIDDENCOLUMNS | R/W: Schreibgeschützt Standardwert: VARIANT_FALSE Beschreibung: Die Anzahl ausgeblendeter Spalten. Wenn DBPROP_UNIQUEROWS den Wert VARIANT_TRUE aufweist, gibt die DBPROP_HIDDENCOLUMNS-Eigenschaft die Anzahl der zusätzlichen ausgeblendeten Spalten zurück, die vom Anbieter hinzugefügt wurden, um Zeilen innerhalb des Rowsets eindeutig zu identifizieren. Diese Spalten werden von IColumnsInfo::GetColumnInfo und IColumnsRowset::GetColumnsRowset zurückgegeben. Sie sind jedoch nicht in der Zeilenanzahl enthalten, die vom pcColumns-Argument zurückgegeben wird, welches wiederum von IColumnsInfo::GetColumnInfo zurückgegeben wird. Zum Bestimmen der Gesamtzahl der Spalten, die in der prgInfo-Struktur dargestellt werden, die von IColumnsInfo::GetColumnInfo zurückgegeben wird (einschließlich ausgeblendeter Spalten), fügt der Consumer der Spaltenanzahl, die von IColumnsInfo::GetColumnInfo in pcColumns zurückgegeben wird, den Wert von DBPROP_HIDDENCOLUMNS hinzu. Wenn DBPROP_UNIQUEROWS den Wert VARIANT_FALSE aufweist, ist DBPROP_HIDDENCOLUMNS gleich Null. |
| DBPROP_IAccessor DBPROP_IColumnsInfo DBPROP_IConvertType DBPROP_IRowset DBPROP_IRowsetInfo | R/W: Schreibgeschützt Standardwert: VARIANT_TRUE Beschreibung: Der SQL Server Native Client OLE DB-Anbieter unterstützt diese Schnittstellen für alle Rowsets. |
| DBPROP_IColumnsRowset | R/W: Lesen/Schreiben Standardwert: VARIANT_TRUE Beschreibung: Der SQL Server Native Client OLE DB-Anbieter unterstützt die IColumnsRowset-Schnittstelle. |
| DBPROP_IConnectionPointContainer | R/W: Lesen/Schreiben Standardwert: VARIANT_FALSE Beschreibung: IConnectionPointContainer. Wenn VARIANT_TRUE festgelegt ist, unterstützt das Rowset die angegebene Schnittstelle. Wenn VARIANT_FALSE festgelegt ist, unterstützt das Rowset die angegebene Schnittstelle nicht. Anbieter, die eine Schnittstelle unterstützen, müssen auch die Eigenschaft, die dieser Schnittstelle zugeordnet ist, mit dem Wert VARIANT_TRUE unterstützen. Diese Eigenschaften werden hauptsächlich dazu verwendet, Schnittstellen durch <legacyBold>ICommandProperties::SetProperties</legacyBold> anzufordern. |
| DBPROP_IMultipleResults | R/W: Lesen/Schreiben Standardwert: VARIANT_FALSE Beschreibung: Der SQL Server Native Client OLE DB-Anbieter unterstützt die IMultipleResults-Schnittstelle. |
| DBPROP_IRowsetChange DBPROP_IRowsetUpdate | R/W: Lesen/Schreiben Standardwert: VARIANT_FALSE Beschreibung: Der SQL Server Native Client OLE DB-Anbieter unterstützt die IRowsetChange- und IRowsetUpdate-Schnittstellen. Ein mit DBPROP_IRowsetChange gleich VARIANT_TRUE erstelltes Rowset zeigt Verhaltensweisen des Sofortupdatemodus. Wenn DBPROP_IRowsetUpdate auf VARIANT_TRUE festgelegt ist, weist DBPROP_IRowsetChange ebenfalls den Wert VARIANT_TRUE auf. Das Rowset zeigt das Verhalten des verzögerten Aktualisierungsmodus. Der SQL Server Native Client OLE DB-Anbieter verwendet einen SQL Server Cursor, um Rowsets zu unterstützen, die IRowsetChange oder IRowsetUpdate verfügbar machen. Weitere Informationen finden Sie unter Rowsets und SQL Server-Cursor. |
| DBPROP_IRowsetIdentity | R/W: Lesen/Schreiben Standardwert: VARIANT_TRUE Beschreibung: Der SQL Server Native Client OLE DB-Anbieter unterstützt die IRowsetIdentity-Schnittstelle. Wenn ein Rowset diese Schnittstelle unterstützt, geben zwei beliebige Zeilenhandles, die die gleiche zugrunde liegende Zeile darstellen, stets die gleichen Daten und Zustandsinformationen wieder. Consumer können die IRowsetIdentity:: IsSameRow-Methode aufrufen, um zwei Handles zu vergleichen und festzustellen, ob sie auf dieselbe Zeileninstanz verweisen. |
| DBPROP_IRowsetLocate DBPROP_IRowsetScroll | R/W: Lesen/Schreiben Standardwert: VARIANT_FALSE Beschreibung: Der SQL Server Native Client OLE DB-Anbieter kann die Schnittstellen IRowsetLocate und IRowsetScroll verfügbar machen. Wenn DBPROP_IRowsetLocate auf VARIANT_TRUE festgelegt ist, weisen DBPROP_CANFETCHBACKWARDS und DBPROP_CANSCROLLBACKWARDS ebenfalls den Wert VARIANT_TRUE auf. Wenn DBPROP_IRowsetScroll auf VARIANT_TRUE festgelegt ist, weist DBPROP_IRowsetLocate ebenfalls den Wert VARIANT_TRUE auf, und beide Schnittstellen sind für das Rowset verfügbar. Lesezeichen sind für beide Schnittstellen erforderlich. Der SQL Server Native Client OLE DB-Anbieter legt DBPROP_BOOKMARKS und DBPROP_LITERALBOOKMARKS auf VARIANT_TRUE fest, wenn der Consumer eine schnittstelle anfordert. Der SQL Server Native Client OLE DB-Anbieter verwendet SQL Server Cursor, um IRowsetLocate und IRowsetScroll zu unterstützen. Weitere Informationen finden Sie unter Rowsets und SQL Server-Cursor. Das Festlegen dieser Eigenschaften in Konflikt mit anderen SQL Server Native Client Cursordefinitionseigenschaften des OLE DB-Anbieters verursacht einen Fehler. Falls Sie beispielsweise DBPROP_IRowsetScroll auf VARIANT_TRUE festlegen, wenn DBPROP_OTHERINSERT ebenfalls den Wert VARIANT_TRUE aufweist, tritt ein Fehler auf, wenn der Consumer versucht, ein Rowset zu öffnen. |
| DBPROP_IRowsetResynch | R/W: Lesen/Schreiben Standardwert: VARIANT_FALSE Beschreibung: Der SQL Server Native Client OLE DB-Anbieter macht die IRowsetResynch-Schnittstelle bei Bedarf verfügbar. Der SQL Server Native Client OLE DB-Anbieters kann die Schnittstelle für ein beliebiges Rowset verfügbar machen. |
| DBPROP_ISupportErrorInfo | R/W: Lesen/Schreiben Standardwert: VARIANT_TRUE Beschreibung: Der SQL Server Native Client OLE DB-Anbieter macht die ISupportErrorInfo-Schnittstelle für Rowsets verfügbar. |
| DBPROP_ILockBytes | Diese Schnittstelle wird nicht vom SQL Server Native Client OLE DB-Anbieter implementiert. Beim Versuch, die Eigenschaft zu lesen oder zu schreiben, wird ein Fehler generiert. |
| DBPROP_ISequentialStream | R/W: Lesen/Schreiben Standardwert: VARIANT_FALSE Beschreibung: Der SQL Server Native Client OLE DB-Anbieter macht die ISequentialStream-Schnittstelle verfügbar, um in SQL Server gespeicherte lange Daten mit variabler Länge zu unterstützen. |
| DBPROP_IStorage | Diese Schnittstelle wird nicht vom SQL Server Native Client OLE DB-Anbieter implementiert. Beim Versuch, die Eigenschaft zu lesen oder zu schreiben, wird ein Fehler generiert. |
| DBPROP_IStream | Diese Schnittstelle wird nicht vom SQL Server Native Client OLE DB-Anbieter implementiert. Beim Versuch, die Eigenschaft zu lesen oder zu schreiben, wird ein Fehler generiert. |
| DBPROP_IMMOBILEROWS | R/W: Lesen/Schreiben Standardwert: VARIANT_TRUE Beschreibung: Die Eigenschaft weist nur für SQL Server-Keysetcursor den Wert VARIANT_TRUE auf. Für alle anderen Cursor lautet sie VARIANT_FALSE. VARIANT_TRUE: Das Rowset ordnet die eingefügten oder aktualisierten Zeilen nicht neu an. Für IRowsetChange::InsertRow werden Zeilen am Ende des Rowsets angezeigt. Für IRowsetChange::SetData wird die Position der aktualisierten Zeilen nicht geändert, wenn das Rowset nicht sortiert ist. Wenn das Rowset sortiert ist und IRowsetChange::SetData eine Spalte ändert, die verwendet wird, um das Rowset zu sortieren, wird die Zeile nicht verschoben. Wenn das Rowset auf einem Satz Schlüsselspalten basiert (in der Regel ein Rowset, für das DBPROP_OTHERUPDATEDELETE den Wert VARIANT_TRUE, DBPROP_OTHERINSERT jedoch den Wert VARIANT_FALSE aufweist), entspricht das Ändern des Werts einer Schlüsselspalte in der Regel dem Löschen der aktuellen Zeile und dem Einfügen einer neuen. Aus diesem Grund kann es so scheinen, als würde sich die Spalte verschieben oder aus dem Rowset entfernt werden, wenn DBPROP_OWNINSERT den Wert VARIANT_FALSE aufweist, obwohl die Eigenschaft DBPROP_IMMOBILEROWS auf VARIANT_TRUE festgelegt ist. VARIANT_FALSE: Wenn das Rowset sortiert ist, werden eingefügte Zeilen in der richtigen Reihenfolge des Rowsets angezeigt. Wenn das Rowset nicht sortiert ist, wird die eingefügte Zeile am Ende angezeigt. Wenn IRowsetChange::SetData eine Spalte ändert, die verwendet wird, um das Rowset zu sortieren, wird die Zeile verschoben. Wenn das Rowset nicht sortiert ist, wird die Position der Zeile nicht verändert. |
| DBPROP_LITERALIDENTITY | R/W: Schreibgeschützt Standardwert: VARIANT_TRUE Beschreibung: Diese Eigenschaft weist immer den Wert VARIANT_TRUE auf. |
| DBPROP_LOCKMODE | R/W: Lesen/Schreiben Standardwert: DBPROPVAL_LM_NONE Beschreibung: Die vom Rowset ausgeführte Sperrebene (DBPROPVAL_LM_NONE, DBPROPVAL_LM_SINGLEROW). Hinweis: Wenn sie Momentaufnahme Isolation in einer Transaktion verwenden, ein Rowset mit einem Keyset oder einem dynamischen Servercursor geöffnet wird und der Sperrmodus auf DBPROPVAL_LM_SINGLEROW festgelegt ist, tritt beim Abrufen einer Zeile ein Fehler auf, wenn eine andere Person diese Zeile seit dem Start der Transaktion aktualisiert hat. Für andere Cursortypen und Sperrmodi gilt: Wenn ein anderer Benutzer die Zeile seit Beginn der Transaktion aktualisiert hat, tritt erst dann ein Fehler auf, wenn der Benutzer versucht, die Zeile zu aktualisieren. In beiden Fällen werden diese Fehler vom Server automatisch generiert. |
| DBPROP_MAXOPENROWS | R/W: Schreibgeschützt Standardwert: 0 Beschreibung: Der SQL Server Native Client OLE DB-Anbieters begrenzt nicht die Anzahl der Zeilen, die in Rowsets aktiv sein können. |
| DBPROP_MAXPENDINGROWS | R/W: Schreibgeschützt Standardwert: 0 Beschreibung: Der SQL Server Native Client OLE DB-Anbieter schränkt die Anzahl der Rowsetzeilen mit ausstehenden Änderungen nicht ein. |
| DBPROP_MAXROWS | R/W: Lesen/Schreiben Standardwert: 0 Beschreibung: Standardmäßig beschränkt der SQL Server Native Client OLE DB-Anbieter die Anzahl der Zeilen in einem Rowset nicht. Wenn der Consumer DBPROP_MAXROWS festlegt, verwendet der SQL Server Native Client OLE DB-Anbieter die SET ROWCOUNT-Anweisung, um die Anzahl der Zeilen im Rowset zu begrenzen. SET ROWCOUNT kann unbeabsichtigte Folgen bei der Ausführung der SQL Server-Anweisung nach sich ziehen. Weitere Informationen finden Sie unter SET ROWCOUNT. |
| DBPROP_MAYWRITECOLUMN | Diese Rowseteigenschaft wird nicht vom SQL Server Native Client OLE DB-Anbieter implementiert. Beim Versuch, den Eigenschaftswert zu lesen oder zu schreiben, wird ein Fehler generiert. |
| DBPROP_MEMORYUSAGE | Diese Rowseteigenschaft wird nicht vom SQL Server Native Client OLE DB-Anbieter implementiert. Beim Versuch, den Eigenschaftswert zu lesen oder zu schreiben, wird ein Fehler generiert. |
| DBPROP_NOTIFICATIONGRANULARITY | Diese Rowseteigenschaft wird nicht vom SQL Server Native Client OLE DB-Anbieter implementiert. Beim Versuch, den Eigenschaftswert zu lesen oder zu schreiben, wird ein Fehler generiert. |
| DBPROP_NOTIFICATIONPHASES | R/W: Schreibgeschützt Standard: DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO | DBPROPVAL_NP_SYNCHAFTER | DBPROPVAL_NP_FAILEDTODO | DBPROPVAL_NP_DIDEVENT Beschreibung: Der SQL Server Native Client OLE DB-Anbieter unterstützt alle Benachrichtigungsphasen. |
| 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: Schreibgeschützt Standard: DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO Beschreibung: Die SQL Server Native Client OLE DB-Anbieterbenachrichtigungsphasen können abgebrochen werden, bevor versucht wird, die angegebene Rowsetänderung durchzuführen. Der SQL Server Native Client OLE DB-Anbieter unterstützt das Phasenabbruch nach Abschluss des Versuchs nicht. |
| DBPROP_ORDEREDBOOKMARKS | Diese Rowseteigenschaft wird nicht vom SQL Server Native Client OLE DB-Anbieter implementiert. Beim Versuch, den Eigenschaftswert zu lesen oder zu schreiben, wird ein Fehler generiert. |
| DBPROP_OTHERINSERT DBPROP_OTHERUPDATEDELETE DBPROP_OWNINSERT DBPROP_OWNUPDATEDELETE | R/W: Lesen/Schreiben Standardwert: VARIANT_FALSE Beschreibung: Das Festlegen von Sichtbarkeitseigenschaften ändern bewirkt, dass der SQL Server Native Client OLE DB-Anbieter SQL Server Cursor verwendet, um das Rowset zu unterstützen. Weitere Informationen finden Sie unter Rowsets und SQL Server-Cursor. |
| DBPROP_QUICKRESTART | R/W: Lesen/Schreiben Standardwert: VARIANT_FALSE Beschreibung: Bei Festlegung auf VARIANT_TRUE versucht der SQL Server Native Client OLE DB-Anbieter, einen Servercursor für das Rowset zu verwenden. |
| DBPROP_REENTRANTEVENTS | R/W: Schreibgeschützt Standardwert: VARIANT_TRUE Beschreibung: Die SQL Server Native Client OLE DB-Anbieterrowsets sind wiedereingeführt und können DB_E_NOTREENTRANT zurückgeben, wenn ein Consumer versucht, über einen Benachrichtigungsrückruf auf eine Rowsetmethode zuzugreifen, die kein Teilnehmer ist. |
| DBPROP_REMOVEDELETED | R/W: Lesen/Schreiben Standardwert: VARIANT_FALSE Beschreibung: Der SQL Server Native Client OLE DB-Anbieter ändert den Wert der Eigenschaft basierend auf der Sichtbarkeit von Änderungen an den SQL Server Daten, die vom Rowset verfügbar gemacht werden. VARIANT_TRUE: Zeilen, die vom Consumer oder anderen SQL Server-Benutzern gelöscht werden, werden beim Aktualisieren eines Rowsets aus dem Rowset entfernt. DBPROP_OTHERINSERT weist den Wert VARIANT_TRUE auf. VARIANT_FALSE: Zeilen, die vom Consumer oder anderen SQL Server-Benutzern gelöscht werden, werden beim Aktualisieren eines Rowsets aus dem Rowset nicht entfernt. Der Zeilenstatuswert für gelöschte SQL Server-Zeilen im Rowset ist DBROWSTATUS_E_DELETED. DBPROP_OTHERINSERT weist den Wert VARIANT_TRUE auf. Diese Eigenschaft verfügt nur über einen Wert für Rowsets, die von SQL Server-Cursorn unterstützt werden. Weitere Informationen finden Sie unter Rowsets und SQL Server-Cursor. Wenn die DBPROP_REMOVEDELETED-Eigenschaft auf einem Keysetcursor-Rowset implementiert wird, werden gelöschte Zeilen zum Zeitpunkt des Abrufens entfernt, und Methoden zum Abrufen von Zeilen wie GetNextRows und GetRowsAt können beide S_OK und weniger Zeilen als angefordert zurückgeben. Beachten Sie, dass dieses Verhalten nicht die DB_S_ENDOFROWSET-Bedingung anzeigt und dass die Anzahl der zurückgegebenen Zeilen niemals Null beträgt, wenn noch verbleibende Zeilen vorliegen. |
| DBPROP_REPORTMULTIPLECHANGES | Diese Rowseteigenschaft wird nicht vom SQL Server Native Client OLE DB-Anbieter implementiert. Beim Versuch, den Eigenschaftswert zu lesen oder zu schreiben, wird ein Fehler generiert. |
| DBPROP_RETURNPENDINGINSERTS | R/W: Schreibgeschützt Standardwert: VARIANT_FALSE Beschreibung: Wenn eine Methode aufgerufen wird, die Zeilen abruft, gibt der SQL Server Native Client OLE DB-Anbieter keine ausstehenden Einfügezeilen zurück. |
| DBPROP_ROWRESTRICT | R/W: Schreibgeschützt Standardwert: VARIANT_TRUE Beschreibung: SQL Server Native Client OLE DB-Anbieterrowsets keine Zugriffsrechte basierend auf der Zeile unterstützen. Wenn die IRowsetChange-Schnittstelle für ein Rowset verfügbar gemacht wird, kann die SetData-Methode vom Consumer aufgerufen werden. |
| DBPROP_ROWSET_ASYNCH | R/W: Lesen/Schreiben Standardwert: 0 Beschreibung: Sorgt für eine asynchrone Rowsetverarbeitung. Diese Eigenschaft befindet sich in der Gruppe der Rowseteigenschaften und im DBPROPSET_ROWSET-Eigenschaftensatz. Der Typ ist VT_14. Der einzige Wert in der Bitmaske, die von SQL Server Native Client unterstützt wird, ist DBPROPVAL_ASYNCH_INITIALIZE. |
| DBPROP_ROWTHREADMODEL | R/W: Schreibgeschützt Standardwert: DBPROPVAL_RT_FREETHREAD Beschreibung: Der SQL Server Native Client OLE DB-Anbieter unterstützt den Zugriff auf seine Objekte aus mehreren Ausführungsthreads eines einzelnen Consumers. |
| DBPROP_SERVERCURSOR | R/W: Lesen/Schreiben Standardwert: VARIANT_FALSE Beschreibung: Sofern festgelegt, wird ein SQL Server-Cursor verwendet, um das Rowset zu unterstützen. Weitere Informationen finden Sie unter Rowsets und SQL Server-Cursor. |
| DBPROP_SERVERDATAONINSERT | R/W: Lesen/Schreiben Standardwert: VARIANT_FALSE Beschreibung: Serverdaten bei Einfügevorgang. VARIANT_TRUE: Wenn ein Einfügevorgang an den Server übertragen wird, ruft der Anbieter Daten vom Server ab, um den lokalen Zeilencache zu aktualisieren. VARIANT_FALSE: Der Anbieter ruft keine Serverwerte für neu eingefügte Zeilen ab. |
| DBPROP_STRONGIDENTITY | R/W: Schreibgeschützt Standardwert: VARIANT_TRUE Beschreibung: Starke Zeilenidentität. Wenn Einfügevorgänge für ein Rowset zulässig sind (entweder IRowsetChange oder IRowsetUpdate ist TRUE) und DBPROP_UPDATABILITY auf die Unterstützung von InsertRows festgelegt ist, hängt der Wert von DBPROP_STRONGIDENTITY von der DBPROP_CHANGEINSERTEDROWS-Eigenschaft ab (er lautet VARIANT_FALSE, wenn der Wert der DBPROP_CHANGEINSERTEDROWS-Eigenschaft VARIANT_FALSE lautet). |
| DBPROP_TRANSACTEDOBJECT | R/W: Schreibgeschützt Standardwert: VARIANT_FALSE Beschreibung: Der SQL Server Native Client OLE DB-Anbieter unterstützt nur transaktionierte Objekte. Weitere Informationen finden Sie unter Transaktionen. |
| DBPROP_UNIQUEROWS | R/W: Lesen/Schreiben Standardwert: VARIANT_FALSE Beschreibung: Eindeutige Zeilen. VARIANT_TRUE: Jede Zeile wird durch ihre Spaltenwerte eindeutig identifiziert. Die Gruppe der Spalten, die die Zeile eindeutig identifizieren, weist den DBCOLUMNFLAGS_KEYCOLUMN-Satz in der DBCOLUMNINFO-Struktur auf, die von der GetColumnInfo-Methode zurückgegeben wird. VARIANT_FALSE: Zeilen werden durch ihre Spaltenwerte eindeutig identifiziert oder nicht. Die Schlüsselspalten sind möglicherweise mit DBCOLUMNFLAGS_KEYCOLUMN gekennzeichnet. |
| DBPROP_UPDATABILITY | R/W: Lesen/Schreiben Standardwert: 0 Beschreibung: Der SQL Server Native Client OLE DB-Anbieter unterstützt alle DBPROP_UPDATABILITY Werte. Durch das Festlegen von DBPROP_UPDATABILITY wird kein änderbares Rowset erstellt. Wenn Sie ein Rowset veränderbar machen möchten, legen Sie DBPROP_IRowsetChange oder DBPROP_IRowsetUpdate fest. |
Der SQL Server Native Client OLE DB-Anbieter definiert den anbieterspezifischen Eigenschaftensatz DBPROPSET_SQLSERVERROWSET, wie in dieser Tabelle dargestellt.
| Eigenschafts-ID | BESCHREIBUNG |
|---|---|
| SSPROP_COLUMN_ID | Spalte: ColumnID R/W: Schreibgeschützt Typ: VT_U12 | VT_ARRAY Standardwert: VT_EMPTY Beschreibung: Ein Array ganzzahliger Werte, die die Ordnungsposition (1-basiert) der Ergebnisspalte einer COMPUTE-Klausel innerhalb der aktuellen Transact-SQL-SELECT-Anweisung darstellen. Dies ist das SQL Server Native Client OLE DB-Anbieteräquivalent des ODBC-SQL_CA_SS_COLUMN_ID-Attributs. |
| SSPROP_DEFERPREPARE | Spalte: Nein R/W: Lesen/Schreiben Typ: VT_BOOL Standardwert: VARIANT_TRUE Beschreibung: VARIANT_TRUE: Bei der vorbereiteten Ausführung wird die Befehlsvorbereitung verzögert, bis ICommand::Execute aufgerufen oder ein Metaeigenschaftenvorgang ausgeführt wird. Wenn die Eigenschaft festgelegt ist auf VARIANT_FALSE: Die Anweisung wird vorbereitet, wenn ICommandPrepare::Prepare ausgeführt wird. |
| SSPROP_IRowsetFastLoad | Spalte: Nein R/W: Lesen/Schreiben Typ: VT_BOOL Standardwert: VARIANT_FALSE Beschreibung: Legen Sie diese Eigenschaft auf VARIANT_TRUE fest, um durch IOpenRowset::OpenRowset ein FastLoad-Rowset zu öffnen. Sie können diese Eigenschaft nicht in ICommandProperties::SetProperties festlegen. |
| SSPROP_ISSAsynchStatus | Spalte: Nein. R/W: Lesen/Schreiben Typ: VT_BOOL Standardwert: VARIANT_FALSE Beschreibung: Legen Sie diese Eigenschaft auf VARIANT_TRUE fest, um asynchrone Vorgänge unter Verwendung der ISSAsynchStatus-Schnittstelle zu aktivieren. |
| SSPROP_MAXBLOBLENGTH | Spalte: Nein R/W: Lesen/Schreiben Typ: VT_I4 Standardwert: Der Anbieter schränkt die Größe des vom Server zurückgegebenen Texts nicht ein, und der Eigenschaftswert wird auf den zulässigen Höchstwert festgelegt. Beispiel: 2147483647. Beschreibung: Der SQL Server Native Client OLE DB-Anbieters führt eine SET TEXTSIZE-Anweisung aus, um die Länge der blob-Daten (Binary Large Object) einzuschränken, die in einer SELECT-Anweisung zurückgegeben werden. |
| SSPROP_NOCOUNT_STATUS | Spalte: NoCount R/W: Schreibgeschützt Typ: VT_BOOL Standardwert: VARIANT_FALSE Beschreibung: Ein boolescher Wert, der den Status von SET NOCOUNT ON/OFF in SQL Server darstellt: VARIANT_TRUE: wenn SET NOCOUNT ON VARIANT_FALSE: wenn SET NOCOUNT OFF |
| SSPROP_QP_NOTIFICATION_MSGTEXT | Spalte: Nein R/W: Lesen/Schreiben Typ: VT_BSTR (1–2000 Zeichen zulässig) Standardwert: leere Zeichenfolge Beschreibung: Der Meldungstext der Abfragebenachrichtigung. Dieser ist benutzerdefiniert und weist kein bestimmtes Format auf. |
| SSPROP_QP_NOTIFICATION_OPTIONS | Spalte: Nein R/W: Lesen/Schreiben Typ: VT_BSTR Standardwert: leere Zeichenfolge Beschreibung: Die Abfragebenachrichtigungsoptionen. Diese werden in einer Zeichenfolge mit name=value angegeben. Der Benutzer ist für das Erstellen des Diensts und Lesen von Benachrichtigungen von der Warteschlange verantwortlich. Die Syntax der Zeichenfolge für die Abfragebenachrichtigungsoptionen lautet:service=<service-name>[;(local database=<database>|broker instance=<broker instance>)]Beispiel: service=mySSBService;local database=mydb |
| SSPROP_QP_NOTIFICATION_TIMEOUT | Spalte: Nein R/W: Lesen/Schreiben Typ: VT_UI4 Standardwert: 432000 Sekunden (5 Tage) Minimum: 1 Sekunde Maximum: 2^31-1 Sekunden Beschreibung: Die Anzahl der Sekunden, die die Abfragebenachrichtigung aktiv bleiben soll. |