行セットのプロパティと動作 (Native Client OLE DB プロバイダー)
適用対象: 
SQL Server Azure SQL データベース 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に設定すると、行セットにサーバー カーソルが使用されます。 Text、ntext、image 列は、アプリケーションがアクセスしないとサーバーから返されません。 |
| 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::GetColumnInfo と IColumnsRowset::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 プロバイダーは、 これらのプロパティを他の 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 プロバイダーは、 |
| 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 プロパティがキーセット カーソルの行セットに実装されている場合、削除された行はフェッチ時に行セットから削除されます。また、GetNextRows や GetRowsAt などの行フェッチ メソッドから、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>|broker instance=<broker instance>)]次に例を示します。 service=mySSBService;local database=mydb |
| SSPROP_QP_NOTIFICATION_TIMEOUT | 列:いいえ R/W:読み取り/書き込み 型: VT_UI4 既定値は432,000 秒 (5 日) 最小:1 秒 最大値:2^31-1 秒 説明:クエリ通知をアクティブのままにしておく秒数。 |