SQL Server Native Client OLE DB プロバイダーは、OLE DB の初期化プロパティと承認プロパティを次のように解釈します。
| プロパティ ID | 説明 |
|---|---|
| DBPROP_AUTH_CACHE_AUTHINFO | SQL Server Native Client OLE DB プロバイダーは認証情報をキャッシュしません。 SQL Server Native Client OLE DB プロバイダーは、プロパティ値を設定しようとしたときにDB_S_ERRORSOCCURREDを返します。 DBPROP 構造体の dwStatus メンバーは、DBPROPSTATUS_NOTSUPPORTEDを示します。 |
| DBPROP_AUTH_ENCRYPT_PASSWORD | SQL Server Native Client OLE DB プロバイダーは、標準の MicrosoftSQL Server セキュリティ メカニズムを使用してパスワードを隠します。 SQL Server Native Client OLE DB プロバイダーは、プロパティ値を設定しようとしたときにDB_S_ERRORSOCCURREDを返します。 DBPROP 構造体の dwStatus メンバーは、DBPROPSTATUS_NOTSUPPORTEDを示します。 |
| DBPROP_AUTH_INTEGRATED | DBPROP_AUTH_INTEGRATEDが NULL ポインター、null 文字列、または 'SSPI' VT_BSTR値に設定されている場合、SQL Server Native Client OLE DB プロバイダーは Windows 認証モードを使用して、DBPROP_INIT_DATASOURCEおよびDBPROP_INIT_CATALOGプロパティで指定された SQL Server データベースへのユーザー アクセスを承認します。 VT_EMPTY (既定値) に設定されている場合は、SQL Server セキュリティが使用されます。 SQL Server のログインとパスワードは、DBPROP_AUTH_USERIDプロパティとDBPROP_AUTH_PASSWORDプロパティで指定されます。 |
| DBPROP_AUTH_MASK_PASSWORD | SQL Server Native Client OLE DB プロバイダーは、標準の SQL Server セキュリティ メカニズムを使用してパスワードを隠します。 SQL Server Native Client OLE DB プロバイダーは、プロパティ値を設定しようとしたときにDB_S_ERRORSOCCURREDを返します。 DBPROP 構造体の dwStatus メンバーは、DBPROPSTATUS_NOTSUPPORTEDを示します。 |
| DBPROP_AUTH_PASSWORD（DBプロパティ認証パスワード） | SQL Server ログインに割り当てられたパスワード。 このプロパティは、SQL Server データベースへのアクセスを承認するために SQL Server 認証が選択されている場合に使用されます。 |
| DBPROP_AUTH_PERSIST_ENCRYPTED | SQL Server Native Client OLE DB プロバイダーは、永続化時に認証情報を暗号化しません。 SQL Server Native Client OLE DB プロバイダーは、プロパティ値を設定しようとしたときにDB_S_ERRORSOCCURREDを返します。 DBPROP 構造体の dwStatus メンバーは、DBPROPSTATUS_NOTSUPPORTEDを示します。 |
| DBPROP_AUTH_機密認証情報の保持 | SQL Server Native Client OLE DB プロバイダーは、パスワードの画像を含む認証値を保持します (要求された場合)。 暗号化は提供されません。 |
| DBPROP_AUTH_USERID | SQL Server ログイン このプロパティは、SQL Server データベースへのアクセスを承認するために SQL Server 認証が選択されている場合に使用されます。 |
| DBPROP_INIT_ASYNCH | SQL Server Native Client OLE DB プロバイダーでは、非同期の開始がサポートされています。 DBPROP_INIT_ASYNCH プロパティにDBPROPVAL_ASYNCH_INITIALIZE ビットを設定すると、 IDBInitialize::Initialize が非ブロッキング呼び出しになります。 詳細については、「 非同期操作の実行」を参照してください。 |
| DBPROP_INIT_CATALOG | 接続先の既存の SQL Server データベースの名前。 |
| DBPROP_INIT_DATASOURCE | MicrosoftSQL Server のインスタンスを実行しているサーバーのネットワーク名。 コンピューター上で実行されている SQL Server のインスタンスが複数ある場合、SQL Server の特定のインスタンスに接続するために、DBPROP_INIT_DATASOURCE値は \\ServerName\InstanceName として指定されます。 エスケープ シーケンス \\ は、円記号自体に使用されます。 |
| DBPROP_INIT_GENERALTIMEOUT | データ ソースの初期化とコマンドの実行以外の要求がタイムアウトするまでの秒数を示します。値 0 は、無限のタイムアウトを示します。ネットワーク接続または分散またはトランザクションのシナリオで動作するプロバイダーは、このプロパティをサポートして、実行時間の長い要求が発生した場合に参加しているコンポーネントにタイムアウトを通知できます。 データ ソースの初期化とコマンド実行のタイムアウトは、それぞれDBPROP_INIT_TIMEOUTとDBPROP_COMMANDTIMEOUTによって制御されます。 DBPROP_INIT_GENERALTIMEOUTは読み取り専用で、設定しようとするとDBPROPSTATUS_NOTSETTABLEの dwstatus エラーが返されます。 |
| DBPROP_INIT_HWND | 呼び出し元アプリケーションからの Windows ハンドル。 初期化プロパティの入力を求めるメッセージが表示される初期化ダイアログ ボックスには、有効なウィンドウ ハンドルが必要です。 |
| DBPROP_INIT_IMPERSONATION_LEVEL | SQL Server Native Client OLE DB プロバイダーは、偽装レベルの調整をサポートしていません。 SQL Server Native Client OLE DB プロバイダーは、プロパティ値を設定しようとしたときにDB_S_ERRORSOCCURREDを返します。 DBPROP 構造体の dwStatus メンバーは、DBPROPSTATUS_NOTSUPPORTEDを示します。 |
| DBPROP_INIT_LCID | SQL Server Native Client OLE DB プロバイダーはロケール ID を検証し、ロケール ID がサポートされていないか、クライアントにインストールされていない場合にエラーを返します。 |
| DBPROP_INIT_LOCATION | SQL Server Native Client OLE DB プロバイダーは、プロパティ値を設定しようとしたときにDB_S_ERRORSOCCURREDを返します。 DBPROP 構造体の dwStatus メンバーは、DBPROPSTATUS_NOTSUPPORTEDを示します。 |
| DBPROP_INIT_MODE | SQL Server Native Client OLE DB プロバイダーは、プロパティ値を設定しようとしたときにDB_S_ERRORSOCCURREDを返します。 DBPROP 構造体の dwStatus メンバーは、DBPROPSTATUS_NOTSUPPORTEDを示します。 |
| DBPROP_INIT_プロンプト | SQL Server Native Client OLE DB プロバイダーでは、データ ソースの初期化に関するすべてのプロンプト モードがサポートされています。 SQL Server Native Client OLE DB プロバイダーは、プロパティの既定の設定としてDBPROMPT_NOPROMPTを使用します。 |
| DBPROP_INIT_PROTECTION_LEVEL | SQL Server Native Client OLE DB プロバイダーは、SQL Server のインスタンスへの接続に対する保護レベルをサポートしていません。 SQL Server Native Client OLE DB プロバイダーは、プロパティ値を設定しようとしたときにDB_S_ERRORSOCCURREDを返します。 DBPROP 構造体の dwStatus メンバーは、DBPROPSTATUS_NOTSUPPORTEDを示します。 |
| DBPROP_INIT_PROVIDERSTRING | このトピックで後述する SQL Server Native Client OLE DB プロバイダー文字列を参照してください。 |
| DBPROP_INIT_TIMEOUT | SQL Server Native Client OLE DB プロバイダーは、指定された秒数以内に SQL Server のインスタンスへの接続を確立できない場合、初期化時にエラーを返します。 |
プロバイダー固有のプロパティ セット DBPROPSET_SQLSERVERDBINITでは、SQL Server Native Client OLE DB プロバイダーによって、これらの追加の初期化プロパティが定義されます。
| プロパティ ID | 説明 |
|---|---|
| SSPROP_AUTH_OLD_PASSWORD | 型: VT_BSTR R/W: 書き込み 既定値: VT_EMPTY 説明: 現在または期限切れのパスワード。 詳細については、「 プログラムによるパスワードの変更」を参照してください。 |
| SSPROP_INIT_APPNAME | 型: VT_BSTR R/W: 読み取り/書き込み 説明: クライアント アプリケーション名。 |
| SSPROP_INIT_AUTOTRANSLATE | 型: VT_BOOL R/W: 読み取り/書き込み 既定値: VARIANT_TRUE 説明: OEM/ANSI 文字変換。 VARIANT_TRUE: SQL Server Native Client OLE DB プロバイダーは、クライアントとサーバーのコード ページ間で拡張文字を照合する際の問題を最小限に抑えるために Unicode を使用して変換することで、クライアントとサーバーの間で送信される ANSI 文字列を変換します。 SQL Serverchar、 varchar、または テキスト 変数、パラメーター、または列のインスタンスに送信されるクライアント DBTYPE_STR データは、クライアント ANSI コード ページ (ACP) を使用して文字から Unicode に変換され、サーバーの ACP を使用して Unicode から文字に変換されます。 クライアント DBTYPE_STR変数に送信された SQL Server char、 varchar、または テキスト データは、サーバー ACP を使用して文字から Unicode に変換された後、クライアント ACP を使用して Unicode から文字に変換されます。 これらの変換は、SQL Server Native Client OLE DB プロバイダーによってクライアントで実行されます。 そのためには、サーバーで使用されているのと同じ ACP をクライアントで使用できる必要があります。 次の設定は、送受信時の変換に影響しません。 Unicode DBTYPE_WSTRサーバー上の char、 varchar、または テキスト に送信されるクライアント データです。 クライアント上の Unicode DBTYPE_WSTR変数に送信される char、 varchar、または テキスト サーバー データ。 ANSI DBTYPE_STRサーバー上の Unicode nchar、nvarchar、または ntext に送信されるクライアント データです。 クライアント上の ANSI DBTYPE_STR変数に送信される Unicode 文字、 varchar、または テキスト サーバー データ。 VARIANT_FALSE: SQL Server Native Client OLE DB プロバイダーは文字変換を実行しません。 SQL Server Native Client OLE DB プロバイダーは、クライアント ANSI 文字DBTYPE_STRサーバー上の char、 varchar、または テキスト 変数、パラメーター、または列に送信されるデータを変換しません。 サーバーからクライアント上の変数をDBTYPE_STRするために送信された char、 varchar、または テキスト データに対して変換は実行されません。 クライアントと SQL Server のインスタンスが異なる ACP を使用している場合、拡張文字が誤って解釈される可能性があります。 |
| SSPROP_INIT_CURRENTLANGUAGE | 型: VT_BSTR R/W: 読み取り/書き込み 説明: SQL Server 言語名。 システム メッセージの選択と書式設定に使用される言語を識別します。 SQL Server のインスタンスを実行しているコンピューターに言語をインストールする必要があります。または、データ ソースの初期化が失敗します。 |
| SSPROP_INIT_DATATYPECOMPATIBILITY | 型: VT_UI2 R/W: 読み取り/書き込み 既定値は0 説明: SQL Server と ActiveX データ オブジェクト (ADO) アプリケーション間のデータ型の互換性を有効にします。 既定値の 0 が使用されている場合、データ型の処理は既定でプロバイダーによって使用されます。 値 80 を使用する場合、データ型の処理では SQL Server 2000 データ型のみが使用されます。 詳細については、「 SQL Server Native Client での ADO の使用」を参照してください。 |
| SSPROP_INIT_ENCRYPT | 型: VT_BOOL R/W: 読み取り/書き込み 既定値: VARIANT_FALSE 説明: ネットワーク経由のデータを暗号化するには、SSPROP_INIT_ENCRYPTプロパティを VARIANT_TRUE に設定します。 [プロトコル暗号化を有効にする] がオンの場合、SSPROP_INIT_ENCRYPTの設定に関係なく、暗号化は常に行われます。 オフで、SSPROP_INIT_ENCRYPTが VARIANT_TRUE に設定されている場合、暗号化が行われます。 [プロトコル暗号化を有効にする] がオフで、SSPROP_INIT_ENCRYPTが VARIANT_FALSE に設定されている場合、暗号化は行われません。 |
| SSPROP_INIT_FAILOVERPARTNER | 型: VT_BSTR R/W: 読み取り/書き込み 説明: データベース ミラーリングのフェールオーバー パートナーの名前を指定します。 これは初期化プロパティであり、初期化前にのみ設定できます。 初期化後、プライマリ サーバーによって返されたフェールオーバー パートナー (存在する場合) が返されます。 これにより、スマート アプリケーションは最近決定されたバックアップ サーバーをキャッシュできますが、このようなアプリケーションでは、接続が最初に確立されたとき (またはプールされた場合はリセット) されたときにのみ情報が更新され、長期的な接続では古くなる可能性があることに注意する必要があります。 接続を確立した後、アプリケーションはこの属性に対してクエリを実行して、フェールオーバー パートナーの ID を判断できます。 プライマリ サーバーにフェールオーバー パートナーがない場合、このプロパティは空の文字列を返します。 詳細については、「 データベース ミラーリングの使用」を参照してください。 |
| SSPROP_INIT_FILENAME | 型: VT_BSTR R/W: 読み取り/書き込み 説明: アタッチ可能なデータベースのプライマリ ファイル名を指定します。 このデータベースがアタッチされ、接続の既定のデータベースとして使用されます。 SSPROP_INIT_FILENAMEを使用するには、初期化プロパティ DBPROP_INIT_CATALOGの値としてデータベースの名前を指定する必要があります。 データベース名が存在しない場合は、SSPROP_INIT_FILENAMEで指定されたプライマリ ファイル名を検索し、DBPROP_INIT_CATALOGで指定された名前でそのデータベースをアタッチします。 データベースが以前にアタッチされていた場合、SQL Server はデータベースを再アタッチしません。 |
| SSPROP_INIT_MARSCONNECTION | 型: VT_BOOL R/W: 読み取り/書き込み 既定値: VARIANT_FALSE 説明: 接続に対して複数のアクティブな結果セット (MARS) を有効にするかどうかを指定します。 データベースに接続する前に、このオプションを true に設定する必要があります。 詳しくは、「複数のアクティブな結果セット (MARS)」をご覧ください。 |
| SSPROP_INIT_NETWORKADDRESS | 型: VT_BSTR R/W: 読み取り/書き込み 説明: DBPROP_INIT_DATASOURCE プロパティで指定された SQL Server のインスタンスを実行しているサーバーのネットワーク アドレス。 |
| SSPROP_INIT_NETWORKLIBRARY | 型: VT_BSTR R/W: 読み取り/書き込み 説明: SQL Server のインスタンスとの通信に使用されるネットワーク ライブラリ (DLL) の名前。 名前には、パスまたは .dll ファイル名拡張子を含めてはなりません。 既定値は、SQL Server クライアント構成ユーティリティを使用してカスタマイズできます。 手記： このプロパティでは、TCP パイプと名前付きパイプのみがサポートされています。 このプロパティをプレフィックスと共に使用すると、内部的にプレフィックスを生成するためにこのプロパティが使用されるため、最終的に二重プレフィックスが発生し、エラーが発生します。 |
| SSPROP_INIT_PACKETSIZE | 型: VT_I4 R/W: 読み取り/書き込み 説明: ネットワーク パケット サイズ (バイト単位)。 パケット サイズのプロパティ値は、512 ~ 32,767 の間である必要があります。 既定の SQL Server Native Client OLE DB プロバイダーのネットワーク パケット サイズは 4,096 です。 |
| SSPROP_INIT_TAGCOLUMNCOLLATION | 型: BOOL R/W: 書き込み 既定値: FALSE 説明: サーバー側カーソルが使用されている場合、データベースの更新中に使用されます。 このプロパティは、クライアントのコード ページではなく、サーバーから取得した照合順序情報でデータにタグを付けます。 現在、このプロパティは、対象データの照合順序を認識し、正しく変換するため、分散クエリ プロセスでのみ使用されます。 |
| SSPROP_INIT_TRUST_SERVER_CERTIFICATE | 型: VT_BOOL R/W: 読み取り/書き込み 既定値: VARIANT_FALSE 説明: サーバー証明書の検証を有効または無効にするために使用されます。 このプロパティは読み取り/書き込みですが、接続が確立された後に設定しようとすると、エラーが発生します。 クライアントが証明書の検証を要求するように構成されている場合、このプロパティは無視されます。 ただし、クライアントが暗号化を必要とせず、クライアントに証明書がプロビジョニングされていない場合でも、アプリケーションはそれをSSPROP_INIT_ENCRYPTと共に使用して、サーバーへの接続が暗号化されることを保証できます。 クライアント アプリケーションは、接続が開かれた後にこのプロパティに対してクエリを実行して、使用中の実際の暗号化と検証の設定を決定できます。 手記： 証明書検証なしで暗号化を使用すると、パケット スニッフィングに対する部分的な保護が提供されますが、中間者攻撃からは保護されません。 サーバー証明書を検証せずに、サーバーに送信されたログインとデータを暗号化するだけです。 詳細については、「 検証なしの暗号化の使用」を参照してください。 |
| SSPROP_INIT_USEPROCFORPREP | 型: VT_I4 R/W: 読み取り/書き込み 既定値: SSPROPVAL_USEPROCFORPREP_ON 説明: SQL Server ストアド プロシージャで使用されます。 ICommandPrepare インターフェイスをサポートするための SQL Server 一時ストアド プロシージャの使用を定義します。 このプロパティは、SQL Server 6.5 に接続する場合にのみ意味がありました。 このプロパティは、以降のバージョンでは無視されます。 SSPROPVAL_USEPROCFORPREP_OFF: コマンドの準備時に一時ストアド プロシージャは作成されません。 SSPROPVAL_USEPROCFORPREP_ON: コマンドの準備時に一時ストアド プロシージャが作成されます。 一時ストアド プロシージャは、セッションが解放されると削除されます。 SSPROPVAL_USEPROCFORPREP_ON_DROP: コマンドの準備時に一時ストアド プロシージャが作成されます。 このプロシージャは、 コマンドが ICommandPrepare::Unprepare で準備されていない場合、 ICommandText::SetCommandText を使用してコマンド オブジェクトに新しいコマンドが指定されたとき、またはコマンドに対するすべてのアプリケーション参照が解放されたときに削除されます。 |
| SSPROP_INIT_WSID | 型: VT_BSTR R/W: 読み取り/書き込み 説明: ワークステーションを識別する文字列。 |
プロバイダー固有のプロパティ セット DBPROPSET_SQLSERVERDATASOURCEINFOでは、SQL Server Native Client OLE DB プロバイダーによって追加のプロパティが定義されます。詳細については、「 データ ソース情報のプロパティ 」を参照してください。
The SQL Server Native Client OLE DB Provider String
SQL Server Native Client OLE DB プロバイダーは、プロバイダー文字列プロパティ値で ODBC に似た構文を認識します。 プロバイダー文字列プロパティは、OLE DB データ ソースへの接続が確立されたときにDBPROP_INIT_PROVIDERSTRING OLE DB 初期化プロパティの値として提供されます。 このプロパティは、OLE DB データ ソースへの接続を実装するために必要な OLE DB プロバイダー固有の接続データを指定します。 文字列内では、要素はセミコロンを使用して区切られます。 文字列の最後の要素はセミコロンで終わる必要があります。 各要素は、キーワード、等号文字、および初期化時に渡される値で構成されます。 例えば次が挙げられます。
Server=MyServer;UID=MyUserName;
SQL Server Native Client OLE DB プロバイダーでは、コンシューマーはプロバイダー文字列プロパティを使用する必要はありません。 コンシューマーは、OLE DB または SQL Server Native Client OLE DB プロバイダー固有の初期化プロパティを使用して、プロバイダー文字列に反映される初期化プロパティを設定できます。
SQL Server Native Client OLE DB プロバイダーで使用できるキーワードの一覧については、「 SQL Server Native Client での接続文字列キーワードの使用」を参照してください。