初期化プロパティと承認プロパティ

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_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_PASSWORD

SQL Server ログインに割り当てられたパスワードです。 このプロパティは、SQL Server データベースへのアクセスの承認に SQL Server 認証が選択された場合に使用されます。

DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO

SQL Server Native Client OLE DB プロバイダーは、認証情報を保存するよう要求された場合に、パスワードのイメージを含めて、この情報を保存します。 暗号化は行われません。

DBPROP_INIT_ASYNCH

SQL Server Native Client OLE DB プロバイダーは、非同期の初期化をサポートします。

DBPROPVAL_ASYNCH_INITIALIZE ビットを DBPROP_INIT_ASYNCH プロパティに設定すると、IDBInitialize::Initialize は非ブロッキング呼び出しになります。 詳細については、「非同期操作の実行」を参照してください。

DBPROP_INIT_DATASOURCE

Microsoft SQL Server インスタンスを実行するサーバーのネットワーク名です。 同じコンピューターに複数の SQL Server インスタンスがある場合は、SQL Server の特定のインスタンスに接続するために、DBPROP_INIT_DATASOURCE の値を \\ServerName\InstanceName の形式で指定します。 エスケープ シーケンスの \\ は、円記号を表すために使用されます。

DBPROP_INIT_HWND

呼び出し元アプリケーションのウィンドウ ハンドルです。 初期化プロパティに入力要求が許可されている場合は、初期化ダイアログ ボックスを表示するために、有効なウィンドウ ハンドルが必要です。

DBPROP_INIT_LCID

SQL Server Native Client OLE DB プロバイダーはロケール ID を検証します。ロケール ID がサポートされていないか、クライアントにインストールされていない場合はエラーを返します。

DBPROP_INIT_MODE

SQL Server Native Client OLE DB プロバイダーは、このプロパティ値の設定が試みられると DB_S_ERRORSOCCURRED を返します。 DBPROP 構造体の dwStatus メンバーは、DBPROPSTATUS_NOTSUPPORTED を示します。

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_TIMEOUT

SQL Server Native Client OLE DB プロバイダーは、SQL Server インスタンスへの接続が指定された時間 (秒単位) 内に確立できなかった場合、初期化時にエラーを返します。

SSPROP_AUTH_OLD_PASSWORD

型: VT_BSTR

R/W: 書き込み

既定値: VT_EMPTY

説明: 現在のパスワードまたは有効期限が切れたパスワードです。 詳細については、「プログラムによるパスワードの変更」を参照してください。

SSPROP_INIT_AUTOTRANSLATE

型: VT_BOOL

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

既定値: VARIANT_TRUE

説明: OEM/ANSI 文字変換です。

VARIANT_TRUE: SQL Server Native Client OLE DB プロバイダーは、クライアントとサーバーの間で送信される ANSI 文字の変換に Unicode を使用することで、クライアントとサーバーのコード ページ間で拡張文字の対応付けに生じる問題を最小限に抑えます。

クライアントの DBTYPE_STR データを SQL Server の char 型、varchar 型、または text 型の変数、パラメーター、列のインスタンスに送信する場合、クライアントの ANSI コード ページ (ACP) に基づいて文字が Unicode に変換され、その後で、サーバーの ACP に基づいて Unicode から文字に変換されます。

SQL Server の char 型、varchar 型、または text 型のデータをクライアントの DBTYPE_STR 変数に送信する場合は、サーバーの ACP に基づいて文字が Unicode に変換され、その後で、クライアントの ACP に基づいて Unicode から文字に変換されます。

この変換は、SQL Server Native Client OLE DB プロバイダーによってクライアントで行われます。 そのため、サーバーで使用しているものと同じ ACP がクライアントでも使用可能になっている必要があります。

次の設定は、送受信時の変換に影響しません。

サーバーの char 型、varchar 型、または text 型に送信される、Unicode の DBTYPE_WSTR クライアント データ。

クライアントの Unicode の DBTYPE_WSTR 変数に送信される、char 型、varchar 型、または text 型のサーバー データ。

サーバーの Unicode の nchar 型、nvarchar 型、または ntext 型に送信される、ANSI DBTYPE_STR クライアント データ。

クライアントの ANSI DBTYPE_STR 変数に送信される、Unicode の char 型、varchar 型、または text 型のサーバー データ。

VARIANT_FALSE: SQL Server Native Client OLE DB プロバイダーは文字変換を行いません。

SQL Server Native Client OLE DB プロバイダーでは、サーバーの char 型、varchar 型、または text 型の変数、パラメーター、列のいずれかに送信される、クライアントの ANSI 文字の DBTYPE_STR データは変換されません。 またサーバーからクライアントの DBTYPE_STR 変数に送信される、char 型、varchar 型、または text 型のデータも変換されません。

クライアントと SQL Server インスタンスが使用する ACP が異なる場合、拡張文字の解釈が正しく行われない場合があります。

SSPROP_INIT_DATATYPECOMPATIBILITY

型: VT_UI2

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

既定値: 0

説明: SQL Server と ActiveX Data Object (ADO) アプリケーション間のデータ型の互換性を確保します。 既定値の 0 が使用されている場合、データ型の処理では、プロバイダーが既定で使用するデータ型が使われます。 値 80 が使用されている場合、データ型の処理では、SQL Server 2000 のデータ型しか使われません。 詳細については、「SQL Server Native Client と ADO の併用」を参照してください。

SSPROP_INIT_FAILOVERPARTNER

型: VT_BSTR

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

説明: データベース ミラーリングのフェールオーバー パートナーの名前を示します。 これは、初期化プロパティで、初期化前にしか設定できません。 初期化後は、フェールオーバー パートナーが構成されている場合は、プライマリ サーバーから返されたフェールオーバー パートナー名を返します。

アプリケーションでは最後に判別したバックアップ サーバーをキャッシュできますが、この情報は最初に接続を確立したとき、または接続がリセットされたとき (接続がプールされている場合) にだけ更新されることに注意する必要があります。接続が長期にわたると、この情報は古くなることがあります。

接続後は、アプリケーションでこの属性をクエリすることにより、フェールオーバー パートナーの ID を判別できます。 プライマリ サーバーのフェールオーバー パートナーが存在しないと、この属性は空文字列を返します。 詳細については、「データベース ミラーリングの使用」を参照してください。

SSPROP_INIT_MARSCONNECTION

型: VT_BOOL

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

既定値: VARIANT_FALSE

説明: 複数のアクティブな結果セット (MARS) が接続で有効かどうかを示します。 このオプションは、データベースへの接続が確立される前に、TRUE に設定する必要があります。 詳細については、「複数のアクティブな結果セット (MARS) の使用」を参照してください。

SSPROP_INIT_NETWORKLIBRARY

型: VT_BSTR

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

説明: SQL Server インスタンスとの通信に使われるネットワーク ライブラリ (DLL) の名前です。 この名前には、パスやファイル拡張子 (.dll) は含めません。

既定値は、SQL Server クライアント構成ユーティリティを使用してカスタマイズできます。

注
このプロパティでは、TCP および名前付きパイプしかサポートされません。 このプロパティにプレフィックスを使用した場合、プレフィックスが二重になりエラーが発生します。これは、内部でこのプロパティを使用してプレフィックスが生成されるためです。

SSPROP_INIT_TAGCOLUMNCOLLATION

型: BOOL

R/W: 書き込み

既定値: FALSE

説明: サーバー側カーソルが使用されているとき、データベースの更新中に使用されます。 このプロパティは、クライアントのコード ページではなく、サーバーから取得した照合順序情報を使用してデータにタグを付けます。 現在、このプロパティは、分散クエリ プロセスでしか使われていません。これは、分散クエリ プロセスでは変換先データの照合順序が認識されていて、データが適切に変換されるためです。

SSPROP_INIT_USEPROCFORPREP

型: VT_I4

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

既定値: SSPROPVAL_USEPROCFORPREP_ON

説明: SQL Server ストアド プロシージャを使用するかどうか。 SQL Server の一時ストアド プロシージャを使用して ICommandPrepare インターフェイスをサポートすることを定義します。 このプロパティは SQL Server 6.5 に接続するときに限り意味がありました。 これ以降のバージョンでは、このプロパティは無視されます。

SSPROPVAL_USEPROCFORPREP_OFF: コマンドを準備するときには、一時ストアド プロシージャが作成されません。

SSPROPVAL_USEPROCFORPREP_ON: コマンドを準備するときに、一時ストアド プロシージャが作成されます。 セッションが解放されると、作成された一時ストアド プロシージャは削除されます。

SSPROPVAL_USEPROCFORPREP_ON_DROP: コマンドを準備するときに、一時ストアド プロシージャが作成されます。 コマンドが ICommandPrepare::Unprepare を使用して準備されていない場合は、ICommandText::SetCommandText を使用してコマンド オブジェクトに新しいコマンドが指定された時点か、コマンドへのアプリケーション参照がすべて解放された時点で、プロシージャは削除されます。