これらは、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に設定すると、ブックマークされた行セットが意味されます。 両方のプロパティが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に設定すると、行セットにサーバー カーソルが使用されます。 テキスト、 ntext、 およびイメージ の列は、アプリケーションからアクセスされるまでサーバーから返されません。 |
| 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 構造体で表される列の合計数を調べるために、コンシューマーは、pcColumns の IColumnsInfo::GetColumnInfo から返された列の数に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の値を持つそのインターフェイスに関連付けられているプロパティをサポートする必要があります。 これらのプロパティは、主に ICommandProperties::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 インターフェイスをサポートしています。 VARIANT_TRUEと等しいDBPROP_IRowsetChangeを使用して作成された行セットは、即時更新モードの動作を示します。 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され、両方のインターフェイスが行セットで使用できます。 どちらのインターフェイスにもブックマークが必要です。 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_OTHERINSERTがVARIANT_TRUEされたときにVARIANT_TRUEにDBPROP_IRowsetScrollを設定すると、コンシューマーが行セットを開こうとするとエラーが生成されます。 |
| 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 プロバイダーは、SQL Server に格納されている長い可変長データをサポートするために ISequentialStream インターフェイスを公開します。 |
| 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_IMMOBILEROWS プロパティがVARIANT_TRUEされている場合でも、DBPROP_OWNINSERTがVARIANT_FALSEされている場合は、行セットを移動したり、行セットから消えたりするように見える場合があります。 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 の場合)、InsertRows をサポートするようにDBPROP_UPDATABILITYが設定されている場合、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 | Column: 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::P repare の実行時に準備されます。 |
| SSPROP_IRowsetFastLoad | 列: いいえ R/W: 読み取り/書き込み 型: VT_BOOL 既定値: VARIANT_FALSE 説明: IOpenRowset::OpenRowset を使用して高速読み込み行セットを開くには、このプロパティを VARIANT_TRUE に設定します。 ICommandProperties::SetProperties では、このプロパティを設定できません。 |
| SSPROP_ISSAsynchStatus | 列: いいえ。 R/W: 読み取り/書き込み 型: VT_BOOL 既定値: VARIANT_FALSE 説明: ISSAsynchStatus インターフェイスを使用して非同期操作を有効にするには、このプロパティを VARIANT_TRUE に設定します。 |
| 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 ~ 2000 文字) 既定値: 空の文字列 説明: クエリ通知のメッセージ テキスト。 これはユーザー定義であり、定義された形式はありません。 |
| 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 既定値: 432000 秒 (5 日) 最小: 1 秒 最大: 2^31-1 秒 説明: クエリ通知がアクティブなままの秒数。 |