行セットのプロパティと動作 (Native Client OLE DB プロバイダー)

適用対象: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

これらは、SQL Server Native Client OLE DB プロバイダーの行セット プロパティです。

プロパティ ID 説明
DBPROP_ABORTPRESERVE R/W:読み取り/書き込み

既定値はVARIANT_FALSE

説明:このプロパティによって、中止操作後の行セットの動作が決まります。

VARIANT_FALSE: SQL Server Native Client OLE DB プロバイダーは、中止操作の後に行セットを無効にします。 行セット オブジェクトの機能は、ほぼ失われます。 サポートされるのは、IUnknown 操作、および未処理の行とアクセサー ハンドルの解放のみです。

VARIANT_TRUE: SQL Server Native Client OLE DB プロバイダーは、有効な行セットを保持します。
DBPROP_ACCESSORDER R/W:読み取り/書き込み

既定値はDBPROPVAL_AO_RANDOM

説明:アクセス順序。 行セット内の列にアクセスする順序を指定します。

DBPROPVAL_AO_RANDOM:任意の順序で列にアクセスできます。

DBPROPVAL_AO_SEQUENTIALSTORAGEOBJECTS:ストレージ オブジェクトとしてバインドされている列は、列序数で決まるシーケンシャルな順序でのみアクセスできます。

DBPROPVAL_AO_SEQUENTIAL:すべての列が、列序数で決まるシーケンシャルな順序でアクセスされる必要があります。
DBPROP_APPENDONLY この行セット プロパティは、SQL Server Native Client OLE DB プロバイダーでは実装されません。 このプロパティ値の読み取りまたは書き込みを行うと、エラーが発生します。
DBPROP_BLOCKINGSTORAGEOBJECTS R/W:読み取り専用

既定値はVARIANT_TRUE

説明: SQL Server Native Client OLE DB プロバイダーのストレージ オブジェクトは、他の行セット メソッドを使用してブロックします。
DBPROP_BOOKMARKS DBPROP_LITERALBOOKMARKS R/W:読み取り/書き込み

既定値 : 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_OTHERINSERT が VARIANT_TRUE のときに、DBPROP_BOOKMARKS を VARIANT_TRUE に設定すると、コンシューマーが行セットを開く時点でエラーが発生します。
DBPROP_BOOKMARKSKIPPED R/W:読み取り専用

既定値はVARIANT_FALSE

説明: SQL Server Native Client OLE DB プロバイダーは、ブックマークされた行セットを配置または検索するときにコンシューマーが無効なブックマークを示した場合にDB_E_BADBOOKMARKを返します。
DBPROP_BOOKMARKTYPE R/W:読み取り専用

既定値はDBPROPVAL_BMK_NUMERIC

説明: SQL Server Native Client OLE DB プロバイダーは、数値ブックマークのみを実装します。 SQL Server Native Client OLE DB プロバイダーのブックマークは、32 ビット符号なし整数で、DBTYPE_UI4型です。
DBPROP_CACHEDEFERRED この行セット プロパティは、SQL Server Native Client OLE DB プロバイダーでは実装されません。 このプロパティ値の読み取りまたは書き込みを行うと、エラーが発生します。
DBPROP_CANFETCHBACKWARDS DBPROP_CANSCROLLBACKWARDS R/W:読み取り/書き込み

既定値 : VARIANT_FALSE

説明: SQL Server Native Client OLE DB プロバイダーは、非必要な行セットでの後方フェッチとスクロールをサポートします。 SQL Server Native Client OLE DB プロバイダーは、DBPROP_CANFETCHBACKWARDSまたはDBPROP_CANSCROLLBACKWARDSがVARIANT_TRUEされたときに、カーソルでサポートされる行セットを作成します。 詳細については、「行セットと SQL Server カーソル」を参照してください。
DBPROP_CANHOLDROWS R/W:読み取り/書き込み

既定値 : VARIANT_FALSE

説明: 既定では、コンシューマーが行セットの行セットの行数を増やそうとしたときに、保留中の変更が現在行セットに存在する場合、SQL Server Native Client OLE DB プロバイダーはDB_E_ROWSNOTRELEASEDを返します。 この動作は変更できます。

DBPROP_CANHOLDROWS と DBPROP_IRowsetChange の両方が VARIANT_TRUE の場合は、ブックマークが設定された行セットになります。 この 2 つのプロパティが VARIANT_TRUE の場合、行セットでは IRowsetLocate インターフェイスを使用でき、DBPROP_BOOKMARKS と DBPROP_LITERALBOOKMARKS の両方が VARIANT_TRUE になります。

ブックマークを含む SQL Server Native Client OLE DB プロバイダー行セットは、SQL Server カーソルでサポートされています。
DBPROP_CHANGEINSERTEDROWS R/W:読み取り/書き込み

既定値はVARIANT_FALSE

説明:行セットがキーセット ドリブン カーソルを使用している場合、このプロパティには VARIANT_TRUE のみ設定できます。
DBPROP_COLUMNRESTRICT R/W:読み取り専用

既定値はVARIANT_FALSE

説明: SQL Server Native Client OLE DB プロバイダーは、コンシューマーが行セット内の列を変更できない場合にVARIANT_TRUEプロパティを設定します。 行セットの他の列は、更新可能にできます。また、行自体を削除することもできます。

このプロパティが VARIANT_TRUE の場合、コンシューマーは DBCOLUMNINFO 構造体の dwFlags メンバーを確認し、各列に値を書き込めるかどうかを判断します。 列が変更可能な場合は、dwFlags は DBCOLUMNFLAGS_WRITE です。
DBPROP_COMMANDTIMEOUT R/W:読み取り/書き込み

既定値は0

説明: 既定では、SQL Server Native Client OLE DB プロバイダーは、 ICommand::Execute メソッドではタイムアウトしません。
DBPROP_COMMITPRESERVE R/W:読み取り/書き込み

既定値はVARIANT_FALSE

説明:このプロパティによって、コミット操作後の行セットの動作が決まります。

VARIANT_TRUE: SQL Server Native Client OLE DB プロバイダーは、有効な行セットを保持します。

VARIANT_FALSE: SQL Server Native Client OLE DB プロバイダーは、コミット操作後に行セットを無効にします。 行セット オブジェクトの機能は、ほぼ失われます。 サポートされるのは、IUnknown 操作、および未処理の行とアクセサー ハンドルの解放のみです。
DBPROP_DEFERRED R/W:読み取り/書き込み

既定値 : VARIANT_FALSE

説明: SQL Server Native Client OLE DB プロバイダーをVARIANT_TRUEに設定すると、行セットにサーバー カーソルが使用されます。 Textntextimage 列は、アプリケーションがアクセスしないとサーバーから返されません。
DBPROP_DELAYSTORAGEOBJECTS R/W:読み取り専用

既定値はVARIANT_FALSE

説明: SQL Server Native Client OLE DB プロバイダーは、ストレージ オブジェクトの即時更新モードをサポートします。

シーケンシャル ストリーム オブジェクトのデータに加えた変更は、直ちに SQL Server に送信されます。 変更は、行セットのトランザクション モードに基づいてコミットされます。
DBPROP_HIDDENCOLUMNS R/W:読み取り専用

既定値はVARIANT_FALSE

説明: 非表示の列数

DBPROP_UNIQUEROWS が VARIANT_TRUE の場合、DBPROP_HIDDENCOLUMNS プロパティは、行セット内の行を一意に識別するためにプロバイダーによって追加された追加の "非表示" 列の数を返します。 これらの列は、IColumnsInfo::GetColumnInfoIColumnsRowset::GetColumnsRowset によって返されます。 ただし、IColumnsInfo::GetColumnInfo によって pcColumns 引数で返される行数には含まれません。

IColumnsInfo::GetColumnInfo によって返される prgInfo 構造体で表される列の総数 (非表示列を含めた数) を調べるには、IColumnsInfo::GetColumnInfo から pcColumns で返される列の数に DBPROP_HIDDENCOLUMNS の値を加算します。 DBPROP_UNIQUEROWS が VARIANT_FALSE の場合、DBPROP_HIDDENCOLUMNS は 0 です。
DBPROP_IAccessor DBPROP_IColumnsInfo DBPROP_IConvertType DBPROP_IRowset DBPROP_IRowsetInfo R/W:読み取り専用

既定値はVARIANT_TRUE

説明: SQL Server Native Client OLE DB プロバイダーは、すべての行セットでこれらのインターフェイスをサポートしています。
DBPROP_IColumnsRowset R/W:読み取り/書き込み

既定値はVARIANT_TRUE

説明: SQL Server Native Client OLE DB プロバイダーは、 IColumnsRowset インターフェイスをサポートしています。
DBPROP_IConnectionPointContainer R/W:読み取り/書き込み

既定値はVARIANT_FALSE

説明:IConnectionPointContainer。 VARIANT_TRUE の場合は、指定したインターフェイスを行セットがサポートします。 VARIANT_FALSE の場合は、指定したインターフェイスを行セットがサポートしません。 インターフェイスをサポートするプロバイダーは、VARIANT_TRUE を指定してインターフェイスに関連付けられたプロパティをサポートする必要があります。 これらのプロパティは、主に、CommandProperties::SetProperties を介してインターフェイスを要求するために使用されます。
DBPROP_IMultipleResults R/W:読み取り/書き込み

既定値 : VARIANT_FALSE

説明: SQL Server Native Client OLE DB プロバイダーは、 IMultipleResults インターフェイスをサポートしています。
DBPROP_IRowsetChange DBPROP_IRowsetUpdate R/W:読み取り/書き込み

既定値 : VARIANT_FALSE

説明: SQL Server Native Client OLE DB プロバイダーは、 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 R/W:読み取り/書き込み

既定値はVARIANT_TRUE

説明: SQL Server Native Client OLE DB プロバイダーは、 IRowsetIdentity インターフェイスをサポートしています。 行セットがこのインターフェイスをサポートする場合、同じ行を基準とする 2 つの行ハンドルは、常に同じデータと状態を示します。 コンシューマーは、IRowsetIdentity::IsSameRow メソッドを呼び出して、2 つの行ハンドルを比較して、同じ行インスタンスを参照しているかどうかを確認できます。
DBPROP_IRowsetLocate DBPROP_IRowsetScroll R/W:読み取り/書き込み

既定値 : VARIANT_FALSE

説明: SQL Server Native Client OLE DB プロバイダーは、 IRowsetLocate および IRowsetScroll インターフェイスを公開できます。

DBPROP_IRowsetLocate が VARIANT_TRUE の場合、DBPROP_CANFETCHBACKWARDS および DBPROP_CANSCROLLBACKWARDS も VARIANT_TRUE になります。

DBPROP_IRowsetScroll が VARIANT_TRUE の場合、DBPROP_IRowsetLocate も VARIANT_TRUE になり、行セットでこの 2 つのインターフェイスが使用可能になります。

ブックマークは、いずれのインターフェイスにも必要です。 SQL Server Native Client OLE DB プロバイダーは、コンシューマーがいずれかのインターフェイスを要求したときに、DBPROP_BOOKMARKSとDBPROP_LITERALBOOKMARKSをVARIANT_TRUEに設定します。

SQL Server Native Client OLE DB プロバイダーは、IRowsetLocate および IRowsetScroll をサポートするために SQL Server カーソルを使用します。 詳細については、「行セットと SQL Server カーソル」を参照してください。

これらのプロパティを他の SQL Server Native Client OLE DB プロバイダーのカーソル定義プロパティと競合して設定すると、エラーが発生します。 たとえば、DBPROP_OTHERINSERT が VARIANT_TRUE のときに、DBPROP_IRowsetScroll を VARIANT_TRUE に設定すると、コンシューマーが行セットを開く時点でエラーが発生します。
DBPROP_IRowsetResynch R/W:読み取り/書き込み

既定値 : VARIANT_FALSE

説明: SQL Server Native Client OLE DB プロバイダーは、 IRowsetResynch インターフェイスをオンデマンドで公開します。 SQL Server Native Client OLE DB プロバイダーは、任意の行セットでインターフェイスを公開できます。
DBPROP_ISupportErrorInfo R/W:読み取り/書き込み

既定値はVARIANT_TRUE

説明: SQL Server Native Client OLE DB プロバイダーは、行セットに ISupportErrorInfo インターフェイスを公開します。
DBPROP_ILockBytes このインターフェイスは、SQL Server Native Client OLE DB プロバイダーによって実装されていません。 このプロパティの読み取りまたは書き込みを行うと、エラーが発生します。
DBPROP_ISequentialStream R/W:読み取り/書き込み

既定値 : VARIANT_FALSE

説明: SQL Server Native Client OLE DB プロバイダーは、ISequentialStream インターフェイスを公開して、SQL Server に格納されている長い可変長データをサポートします。
DBPROP_IStorage このインターフェイスは、SQL Server Native Client OLE DB プロバイダーによって実装されていません。 このプロパティの読み取りまたは書き込みを行うと、エラーが発生します。
DBPROP_IStream このインターフェイスは、SQL Server Native Client OLE DB プロバイダーによって実装されていません。 このプロパティの読み取りまたは書き込みを行うと、エラーが発生します。
DBPROP_IMMOBILEROWS R/W:読み取り/書き込み

既定値はVARIANT_TRUE

説明:このプロパティは、SQL Server のキーセット カーソルの場合のみ VARIANT_TRUE で、それ以外のカーソルの場合は 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

説明: SQL Server Native Client OLE DB プロバイダーでは、行セットでアクティブにできる行の数は制限されません。
DBPROP_MAXPENDINGROWS R/W:読み取り専用

既定値は0

説明: SQL Server Native Client OLE DB プロバイダーでは、変更が保留中の行セット行の数は制限されません。
DBPROP_MAXROWS R/W:読み取り/書き込み

既定値は0

説明: 既定では、SQL Server Native Client OLE DB プロバイダーは、行セット内の行数を制限しません。 コンシューマーがDBPROP_MAXROWSを設定すると、SQL Server Native Client OLE DB プロバイダーは SET ROWCOUNT ステートメントを使用して行セット内の行数を制限します。

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 R/W:読み取り専用

既定値: 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 R/W:読み取り専用

既定値: 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 R/W:読み取り/書き込み

既定値 : VARIANT_FALSE

説明: 表示プロパティの変更を設定すると、SQL Server Native Client OLE DB プロバイダーは SQL Server カーソルを使用して行セットをサポートします。 詳細については、「行セットと SQL Server カーソル」を参照してください。
DBPROP_QUICKRESTART R/W:読み取り/書き込み

既定値 : VARIANT_FALSE

説明: VARIANT_TRUEに設定すると、SQL Server Native Client OLE DB プロバイダーは行セットにサーバー カーソルを使用しようとします。
DBPROP_REENTRANTEVENTS R/W:読み取り専用

既定値はVARIANT_TRUE

説明: SQL Server Native Client OLE DB プロバイダー行セットは再入可能であり、コンシューマーが通知コールバックから非参加行セット メソッドにアクセスしようとすると、DB_E_NOTREENTRANTを返すことができます。
DBPROP_REMOVEDELETED R/W:読み取り/書き込み

既定値 : 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 プロパティがキーセット カーソルの行セットに実装されている場合、削除された行はフェッチ時に行セットから削除されます。また、GetNextRowsGetRowsAt などの行フェッチ メソッドから、S_OK および要求された行数よりも少ない行を返すことができます。 この動作は、DB_S_ENDOFROWSET の状態を示すものではないこと、また、返される行数は、残りの行がある場合は決して 0 にならないことに注意してください。
DBPROP_REPORTMULTIPLECHANGES この行セット プロパティは、SQL Server Native Client OLE DB プロバイダーでは実装されません。 このプロパティ値の読み取りまたは書き込みを行うと、エラーが発生します。
DBPROP_RETURNPENDINGINSERTS R/W:読み取り専用

既定値はVARIANT_FALSE

説明: 行をフェッチするメソッドが呼び出されると、SQL Server Native Client OLE DB プロバイダーは保留中の挿入行を返しません。
DBPROP_ROWRESTRICT R/W:読み取り専用

既定値はVARIANT_TRUE

説明: SQL Server Native Client OLE DB プロバイダーの行セットは、行に基づくアクセス権をサポートしていません。 行セットで IRowsetChange インターフェイスが公開されている場合、SetData メソッドをコンシューマーから呼び出すことができます。
DBPROP_ROWSET_ASYNCH R/W:読み取り/書き込み

既定値は0

説明:行セットの非同期処理を提供します。 このプロパティは、Rowset プロパティ グループおよび DBPROPSET_ROWSET プロパティ セットに含まれています。 型は VT_14 です。

SQL Server Native Client でサポートされるビットマスクの値は、 DBPROPVAL_ASYNCH_INITIALIZEのみです。
DBPROP_ROWTHREADMODEL R/W:読み取り専用

既定値はDBPROPVAL_RT_FREETHREAD

説明: SQL Server Native Client OLE DB プロバイダーは、1 つのコンシューマーの複数の実行スレッドからオブジェクトへのアクセスをサポートします。
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

説明:厳密な行 ID。 行セットに対して挿入が許可されていて (IRowsetChange または IRowsetUpdate が TRUE)、DBPROP_UPDATABILITY が InsertRows をサポートするように設定されている場合、DBPROP_STRONGIDENTITY の値は DBPROP_CHANGEINSERTEDROWS プロパティの値により決まります (DBPROP_CHANGEINSERTEDROWS プロパティの値が VARIANT_FALSE の場合は VARIANT_FALSE になります)。
DBPROP_TRANSACTEDOBJECT R/W:読み取り専用

既定値はVARIANT_FALSE

説明: SQL Server Native Client OLE DB プロバイダーは、トランザクション オブジェクトのみをサポートします。 詳細については、「トランザクション」を参照してください。
DBPROP_UNIQUEROWS R/W:読み取り/書き込み

既定値はVARIANT_FALSE

説明:一意の行。

VARIANT_TRUE:各行は、その列の値で一意に識別されます。 行を一意に識別する列のセットは、GetColumnInfo メソッドから返される DBCOLUMNINFO 構造体の DBCOLUMNFLAGS_KEYCOLUMN に設定されます。

VARIANT_FALSE:行は、その列の値で一意に識別される場合とされない場合があります。 またキー列は、DBCOLUMNFLAGS_KEYCOLUMN によって示されない場合があります。
DBPROP_UPDATABILITY R/W:読み取り/書き込み

既定値は0

説明: SQL Server Native Client OLE DB プロバイダーは、すべてのDBPROP_UPDATABILITY値をサポートします。 DBPROP_UPDATABILITY を設定しても、更新可能な行セットが作成されるわけではありません。 行セットを更新可能にするには、DBPROP_IRowsetChange または DBPROP_IRowsetUpdate を設定してください。

SQL Server Native Client OLE DB プロバイダーは、次の表に示すように、プロバイダー固有のプロパティ セットDBPROPSET_SQLSERVERROWSET定義します。

プロパティ ID 説明
SSPROP_COLUMN_ID 列:ColumnID

R/W:読み取り専用

型 : VT_U12 | VT_ARRAY

既定値はVT_EMPTY

説明: 現在の Transact-SQL SELECT ステートメント内にある COMPUTE 句の結果列の序数位置 (1 から始まります) を表す整数値の配列。 これは、ODBC SQL_CA_SS_COLUMN_ID属性と同等の SQL Server Native Client OLE DB プロバイダーです。
SSPROP_DEFERPREPARE 列:いいえ

R/W:読み取り/書き込み

型: VT_BOOL

既定値はVARIANT_TRUE

説明:VARIANT_TRUE:準備実行では、ICommand::Execute が呼び出されるか、メタプロパティ操作が実行されるまで、コマンドの準備が遅延されます。 プロパティが次の値に設定されている場合は、ステートメントの準備が行われます。

VARIANT_FALSE:ICommandPrepare::Prepare が実行されたとき、ステートメントが準備されます。
SSPROP_IRowsetFastLoad 列:いいえ

R/W:読み取り/書き込み

型: VT_BOOL

既定値はVARIANT_FALSE

説明:このプロパティを VARIANT_TRUE に設定すると、IOpenRowset::OpenRowset から行セットを高速に読み込んで開くことができます。 ICommandProperties::SetProperties でこのプロパティを設定することはできません。
SSPROP_ISSAsynchStatus 列:いいえ。

R/W:読み取り/書き込み

型: VT_BOOL

既定値はVARIANT_FALSE

説明:このプロパティを VARIANT_TRUE に設定すると、ISSAsynchStatus インターフェイスを使用した非同期操作を実行できます。
SSPROP_MAXBLOBLENGTH 列:いいえ

R/W:読み取り/書き込み

型: VT_I4

既定値はこのプロバイダーでは、サーバーから返されるテキストのサイズを制限しません。プロパティ値は最大値に設定されます。 たとえば、2147483647 に設定されます。

説明: SQL Server Native Client OLE DB プロバイダーは、SET TEXTSIZE ステートメントを実行して、SELECT ステートメントで返されるバイナリ ラージ オブジェクト (BLOB) データの長さを制限します。
SSPROP_NOCOUNT_STATUS 列:NoCount

R/W:読み取り専用

型: VT_BOOL

既定値はVARIANT_FALSE

説明:SQL Server の SET NOCOUNT ON/OFF の状態を表すブール値です。

VARIANT_TRUE: SET NOCOUNT ON の場合

VARIANT_FALSE: SET NOCOUNT OFF の場合
SSPROP_QP_NOTIFICATION_MSGTEXT 列:いいえ

R/W:読み取り/書き込み

型: VT_BSTR (許可される文字数: 1 から 2,000 文字)

既定値は空の文字列

説明:クエリ通知のメッセージ テキストです。 これはユーザーが定義するので、定義済みの書式はありません。
SSPROP_QP_NOTIFICATION_OPTIONS 列:いいえ

R/W:読み取り/書き込み

型: VT_BSTR

既定値は空の文字列

説明:クエリ通知オプション。 これらは name=value 形式の文字列で指定されます。 ユーザーがサービスを作成して、キューから通知を読み取る必要があります。 クエリ通知オプションの構文を次に示します。

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

次に例を示します。

service=mySSBService;local database=mydb
SSPROP_QP_NOTIFICATION_TIMEOUT 列:いいえ

R/W:読み取り/書き込み

型: VT_UI4

既定値は432,000 秒 (5 日)

最小:1 秒

最大値:2^31-1 秒

説明:クエリ通知をアクティブのままにしておく秒数。

参照

行セット