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

適用対象:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

OLE DB ドライバーのダウンロード

OLE DB Driver for SQL Server では、OLE DB 初期化プロパティと承認プロパティを次のように解釈します。

プロパティ ID 説明
DBPROP_AUTH_CACHE_AUTHINFO OLE DB Driver for SQL Server は、認証情報をキャッシュしません。

OLE DB Driver for SQL Server は、このプロパティ値の設定が試みられると DB_S_ERRORSOCCURRED を返します。 DBPROP 構造体の dwStatus メンバーは、DBPROPSTATUS_NOTSUPPORTED を示します。
DBPROP_AUTH_ENCRYPT_PASSWORD OLE DB Driver for SQL Server は、標準の Microsoft SQL Server セキュリティ メカニズムを使用してパスワードを隠します。

OLE DB Driver for SQL Server は、このプロパティ値の設定が試みられると DB_S_ERRORSOCCURRED を返します。 DBPROP 構造体の dwStatus メンバーは、DBPROPSTATUS_NOTSUPPORTED を示します。
DBPROP_AUTH_INTEGRATED DBPROP_AUTH_INTEGRATED に NULL ポインター、NULL 文字列、または 'SSPI' VT_BSTR 値を設定すると、OLE DB Driver for SQL Server は、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 OLE DB Driver for SQL Server は、標準の SQL Server セキュリティ メカニズムを使用してパスワードを隠します。

OLE DB Driver for SQL Server は、このプロパティ値の設定が試みられると DB_S_ERRORSOCCURRED を返します。 DBPROP 構造体の dwStatus メンバーは、DBPROPSTATUS_NOTSUPPORTED を示します。
DBPROP_AUTH_PASSWORD SQL Server ログインに割り当てられたパスワードです。 このプロパティは、SQL Server データベースへのアクセスの承認に SQL Server 認証が選択された場合に使用されます。
DBPROP_AUTH_PERSIST_ENCRYPTED OLE DB Driver for SQL Server は、認証情報を保存するとき、この情報を暗号化しません。

OLE DB Driver for SQL Server は、このプロパティ値の設定が試みられると DB_S_ERRORSOCCURRED を返します。 DBPROP 構造体の dwStatus メンバーは、DBPROPSTATUS_NOTSUPPORTED を示します。
DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO OLE DB Driver for SQL Server は、認証値を保存するよう要求された場合に、パスワードのイメージを含めて、この値を保存します。 暗号化は行われません。
DBPROP_AUTH_USERID SQL Server ログインです。 このプロパティは、SQL Server データベースへのアクセスの承認に SQL Server 認証が選択された場合に使用されます。
DBPROP_INIT_ASYNCH OLE DB Driver for SQL Server は、非同期の初期化をサポートします。

DBPROPVAL_ASYNCH_INITIALIZE ビットを DBPROP_INIT_ASYNCH プロパティに設定すると、IDBInitialize::Initialize は非ブロッキング呼び出しになります。 詳細については、「非同期操作の実行」を参照してください。
DBPROP_INIT_CATALOG 接続先の既存の SQL Server データベース名です。
DBPROP_INIT_DATASOURCE Microsoft SQL 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 呼び出し元アプリケーションのウィンドウ ハンドルです。 初期化プロパティに入力要求が許可されている場合は、初期化ダイアログ ボックスを表示するために、有効なウィンドウ ハンドルが必要です。
DBPROP_INIT_IMPERSONATION_LEVEL OLE DB Driver for SQL Server は、偽装レベルの調整をサポートしません。

OLE DB Driver for SQL Server は、このプロパティ値の設定が試みられると DB_S_ERRORSOCCURRED を返します。 DBPROP 構造体の dwStatus メンバーは、DBPROPSTATUS_NOTSUPPORTED を示します。
DBPROP_INIT_LCID OLE DB Driver for SQL Server でロケール ID が確認され、ロケール ID がサポートされていないか、クライアントにインストールされていない場合はエラーが返されます。
DBPROP_INIT_LOCATION OLE DB Driver for SQL Server は、このプロパティ値の設定が試みられると DB_S_ERRORSOCCURRED を返します。 DBPROP 構造体の dwStatus メンバーは、DBPROPSTATUS_NOTSUPPORTED を示します。
DBPROP_INIT_MODE OLE DB Driver for SQL Server は、このプロパティ値の設定が試みられると DB_S_ERRORSOCCURRED を返します。 DBPROP 構造体の dwStatus メンバーは、DBPROPSTATUS_NOTSUPPORTED を示します。
DBPROP_INIT_PROMPT OLE DB Driver for SQL Server では、データ ソースを初期化するためのすべての入力要求モードがサポートされています。 OLE DB Driver for SQL Server は、このプロパティの既定の設定として DBPROMPT_NOPROMPT を使用します。
DBPROP_INIT_PROTECTION_LEVEL OLE DB Driver for SQL Server は、SQL Server インスタンスへの接続で保護レベルをサポートしません。

OLE DB Driver for SQL Server は、このプロパティ値の設定が試みられると DB_S_ERRORSOCCURRED を返します。 DBPROP 構造体の dwStatus メンバーは、DBPROPSTATUS_NOTSUPPORTED を示します。
DBPROP_INIT_PROVIDERSTRING このトピックで後述する「OLE DB Driver for SQL Server の文字列」を参照してください。
DBPROP_INIT_TIMEOUT OLE DB Driver for SQL Server は、SQL Server のインスタンスへの接続が指定された時間 (秒単位) 内に確立できなかった場合、初期化時にエラーを返します。

プロバイダー固有のプロパティ セット DBPROPSET_SQLSERVERDBINIT には、OLE DB Driver for SQL Server により、次の追加の初期化プロパティが定義されます。

プロパティ ID 説明
SSPROP_AUTH_ACCESS_TOKEN1 型: VT_BSTR

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

既定値はVT_EMPTY

説明: Microsoft Entra ID に対する認証に使用されるアクセス トークン。

注: このプロパティを指定し、UIDPWDTrusted_Connection、または Authentication 接続文字列キーワードまたはそれに対応するプロパティ/キーワードも指定すると、エラーになります。
SSPROP_AUTH_MODE1 型: VT_BSTR

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

既定値はVT_EMPTY

説明: 使用する SQL または Microsoft Entra 認証を指定します。 有効な値は次のとおりです。
  • (not set):他のキーワードによって決定される認証モード。
  • (empty string):以前に設定した認証モードの設定を解除します。
  • ActiveDirectoryPassword:Microsoft Entra ID を使用したユーザー名とパスワードの認証。
  • ActiveDirectoryIntegrated: Microsoft Entra ID との統合認証。

  • 注:ActiveDirectoryIntegrated キーワードは、SQL Server に対する Windows 認証でも使用できます。 これは、Integrated Security (または Trusted_Connection) 認証キーワードに代わるものです。 Integrated Security (または Trusted_Connection) キーワードまたはそれに対応するプロパティを使用するアプリケーションで、Authentication キーワード (またはそれに対応するプロパティ) の値を ActiveDirectoryIntegrated に設定して、新しい暗号化および証明書の検証の動作を有効にすることをお勧めします。

  • ActiveDirectoryInteractive: Microsoft Entra ID を使用した対話型認証。 この方法では、Microsoft Entra 多要素認証がサポートされます。
  • ActiveDirectoryMSI:マネージド ID 認証。 ユーザー割り当て ID の場合、ユーザー ID はユーザー ID のオブジェクト ID に設定する必要があります。
  • ActiveDirectoryServicePrincipal: Microsoft Entra アプリケーションを使用したサービス プリンシパル認証。 ユーザー ID はアプリケーション (クライアント) ID に設定する必要があります。 パスワードはアプリケーション (クライアント) シークレットに設定する必要があります。
  • SqlPassword: ユーザー ID とパスワードを使用した認証。

  • 注:SQL Server 認証を使用するアプリケーションで、Authentication キーワード (またはそれに対応するプロパティ) の値を SqlPassword に設定して、新しい暗号化および証明書の検証の動作を有効にすることをお勧めします。
SSPROP_AUTH_OLD_PASSWORD 型: VT_BSTR

R/W:Write

既定値はVT_EMPTY

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

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

説明:クライアント アプリケーション名。
SSPROP_INIT_AUTOTRANSLATE 型: VT_BOOL

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

既定値はVARIANT_TRUE

説明:OEM/ANSI 文字の変換。

VARIANT_TRUE:OLE DB Driver for SQL Server は、クライアントとサーバーの間で送信される ANSI 文字列の変換に Unicode を使用することで、クライアントとサーバーのコード ページ間で拡張文字を照合するときに生じる問題を最小限に抑えます。

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

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

OLE DB Driver のバージョン 18.6.4 および 19.1 以降の場合、上記の変換は、SSVARIANT 構造体の CharVal メンバーと SQL Server sql_variant 変数、パラメーター、または列のインスタンスの間で転送されるデータにも適用されます。

この変換は、OLE DB Driver for SQL Server によってクライアントで行われます。 そのため、サーバーで使用しているものと同じ 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:OLE DB Driver for SQL Server は、文字の変換を行いません。

OLE DB Driver for SQL Server では、サーバーの char 型、varchar 型、または text 型の変数、パラメーター、列のいずれかに送信される、クライアントの ANSI 文字の DBTYPE_STR データは変換されません。 また、サーバーからクライアントの DBTYPE_STR 変数に送信される、char 型、varchar 型、text 型のデータも変換されません。 同じように、OLE DB Driver のバージョン 18.6.4 および 19.1 以降の場合、ドライバーは SSVARIANT 構造体の CharVal メンバーと SQL Server sql_variant 変数、パラメーター、または列のインスタンスの間で転送されるデータを移動させません。

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

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

既定値は1

説明: 接続が失われた場合の再接続試行回数を制御します。 詳細については、アイドル状態の接続の回復性に関するページを参照してください。
SSPROP_INIT_CONNECT_RETRY_INTERVAL 型: VT_I4

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

既定値は10

説明: 接続が失われた場合の各接続再試行の間隔を秒数で指定します。 詳細については、アイドル状態の接続の回復性に関するページを参照してください。
SSPROP_INIT_CURRENTLANGUAGE 型: VT_BSTR

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

説明:SQL Server の言語名。 システム メッセージの選択や書式設定に使われる言語を示します。 指定された言語が SQL Server インスタンスを実行するコンピューターにインストールされていないと、データ ソースの初期化が失敗します。
SSPROP_INIT_DATATYPECOMPATIBILITY 型: VT_UI2

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

既定値は0

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

R/W: 読み取り

説明: 接続のサーバー SPN のクエリを実行するために使用します。 (バージョン 18.6.3 以降)
SSPROP_INIT_ENCRYPT1 型: VT_BSTR

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

既定値: Mandatory

説明: ネットワークを経由するデータを暗号化するかどうかを指定します。

[プロトコルの暗号化を設定する] がオンになっている場合、SSPROP_INIT_ENCRYPT の設定に関係なく、常に暗号化が行われます。 プロトコルの暗号化が無効な場合でも、SSPROP_INIT_ENCRYPT が MandatoryStrict に設定されている場合は、暗号化が行われます。

[プロトコルの暗号化を設定する] がオフになっていて、SSPROP_INIT_ENCRYPT が Optional に設定されている場合は、暗号化は行われません。 有効な値は、OptionalMandatoryStrict です。 バージョン 18.x.x については、MSOLEDBSQL のメジャー バージョン間の違いに関するページを参照してください。
SSPROP_INIT_FAILOVERPARTNER 型: VT_BSTR

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

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

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

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

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

既定値はVT_EMPTY

説明: フェールオーバー パートナーの SPN を指定します。 空の文字列を使用すると、OLE DB Driver for SQL Server ではプロバイダーが生成した SPN が既定値として使用されます。
SSPROP_INIT_FILENAME 型: VT_BSTR

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

説明:アタッチできるデータベースのプライマリ ファイル名を指定します。 このデータベースがアタッチされ、接続の既定のデータベースとして使用されます。 SSPROP_INIT_FILENAME を使用するには、初期化プロパティ DBPROP_INIT_CATALOG の値にデータベース名を指定する必要があります。 指定したデータベース名が存在しない場合は、SSPROP_INIT_FILENAME に指定されているプライマリ ファイル名を確認し、そのデータベースと DBPROP_INIT_CATALOG に指定されている名前とをアタッチします。 データベースが以前にアタッチされていた場合は、SQL Server はこれを再アタッチしません。
SSPROP_INIT_HOST_NAME_CERTIFICATE 型: VT_BSTR

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

既定値はVT_EMPTY

説明: SQL Server TLS/SSL 証明書の検証に使われるホスト名。 SSPROP_INIT_HOST_NAME_CERTIFICATE プロパティが設定されていない場合、ドライバーでは SQL Server TLS/SSL 証明書の検証に DBPROP_INIT_DATASOURCE プロパティの値をホスト名として使います。
SSPROP_INIT_MARSCONNECTION 型: VT_BOOL

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

既定値はVARIANT_FALSE

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

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

既定値はVARIANT_FALSE

説明:MultiSubnetFailover を使用することで、SQL Server のすべての Always On 可用性グループおよびフェールオーバー クラスター インスタンスに対して高速フェールオーバーが有効化され、単一サブネットおよびマルチサブネットの AlwaysOn トポロジにおけるフェールオーバー時間が大幅に短縮されます。 マルチサブネット フェールオーバーの際には、クライアントは複数の接続を並列で試行します。 詳細については、「OLE DB Driver for SQL Server の高可用性、ディザスター リカバリーに関するサポート」を参照してください。
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:読み取り/書き込み

説明:バイト単位の表形式データ ストリーム (TDS) パケット サイズ。 このパケット サイズ プロパティの値は 0 または 512 から 32,767 の間にする必要があります。 既定値は 0 です。これは、実際のパケット サイズがサーバーによって決定されることを意味します。
SSPROP_INIT_SERVER_CERTIFICATE 型: VT_BSTR

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

既定値はVT_EMPTY

説明: SQL Server の TLS/SSL 証明書と照合する証明書ファイルへのパスを指定します。 このオプションは、Strict 暗号化が有効になっている場合にのみ使用できます。 受け付けられる証明書の形式は PEM、DER、CER です。 指定した場合、SQL Server の証明書は、指定された証明書が完全に一致するかどうかを確認することでチェックされます。
SSPROP_INIT_SERVERSPN 型: VT_BSTR

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

既定値はVT_EMPTY

説明: サーバーの SPN を指定します。 空の文字列を使用すると、OLE DB Driver for SQL Server ではプロバイダーが生成した SPN が既定値として使用されます。
SSPROP_INIT_TAGCOLUMNCOLLATION 型: VT_BOOL

R/W:Write

既定値はVARIANT_FALSE

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

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

既定値はVARIANT_TRUE

説明:ホスト名に複数の IP が関連付けられている場合、ホスト名の最初に解決された IP が応答しないと、TNIR が接続シーケンスに影響を与えます。 TNIR では、MultiSubnetFailover と連動して、異なる接続シーケンスが提供されます。 詳しくは、「透過的なネットワーク IP の解決の使用」をご覧ください。
SSPROP_INIT_TRUST_SERVER_CERTIFICATE1 型: VT_BOOL

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

既定値はVARIANT_FALSE

説明:サーバー証明書の検証の有効化または無効化に使用されます。 このプロパティは読み取り/書き込みですが、接続の確立後にこの値の設定が試みられると、エラーが発生します。

このプロパティは、クライアントが証明書の検証を要求するよう構成されている場合は、無視されます。 ただし、アプリケーションは、このプロパティを SSPROP_INIT_ENCRYPT と共に使用して、クライアントが暗号化を要求するよう構成されておらず、証明書がクライアント側に準備されていない場合でも、アプリケーションとサーバー間の接続が確実に暗号化されるようにすることができます。

クライアント アプリケーションでは、接続を開いた後にこの属性をクエリして、実際に使用されている暗号化と検証の設定を判断できます。

注:証明書の検証なしで暗号化を使用する場合、パケット スニッフィングからは部分的に保護されますが、中間者攻撃からは保護されません。 この場合、サーバー証明書を検証せずに、サーバーに送られるログインとデータの暗号化が行われます。

詳細については、「Encryption and certificate validation」 (暗号化と証明書の検証) を参照してください。
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 を使用してコマンド オブジェクトに新しいコマンドが指定されたとき、またはコマンドへのアプリケーション参照がすべて解放されたときに、プロシージャは削除されます。
SSPROP_INIT_WSID 型: VT_BSTR

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

説明:ワークステーションを識別する文字列。

[1]:セキュリティを強化するために、認証/アクセス トークンの初期化プロパティまたはそれに対応する接続文字列キーワードを使用する場合の、暗号化と証明書の検証の動作が変更されています。 詳細については、「暗号化と証明書の検証」を参照してください。

OLE DB Driver for SQL Server は、プロバイダー固有のプロパティ セット DBPROPSET_SQLSERVERDATASOURCEINFO に追加のプロパティを定義します。詳細については、「データ ソース情報のプロパティ」を参照してください。

OLE DB Driver for SQL Server の文字列

OLE DB Driver for SQL Server は、プロバイダーの文字列プロパティ値で、ODBC と同様の構文を認識します。 プロバイダーの文字列プロパティは、OLE DB データ ソースへの接続が確立される時点で、OLE DB 初期化プロパティ DBPROP_INIT_PROVIDERSTRING の値として提供されます。 このプロパティは、OLE DB データ ソースへの接続の実装に必要な OLE DB プロバイダー固有の接続データを示します。 この文字列内では、要素がセミコロンを使用して区切られます。 文字列の最後の要素には、セミコロンを付けて、終端を示す必要があります。 各要素は、キーワード、等号文字、初期化時に渡される値で構成されます。 次に例を示します。

Server=MyServer;UID=MyUserName;  

OLE DB Driver for SQL Server では、コンシューマーはプロバイダーの文字列プロパティを使用する必要がありません。 コンシューマーは、OLE DB または OLE DB Driver for SQL Server プロバイダー固有の初期化プロパティを使用して、プロバイダー文字列に任意の初期化プロパティを設定できます。

OLE DB Driver for SQL Server で使用可能なキーワードの一覧については、「OLE DB Driver for SQL Server での接続文字列キーワードの使用」を参照してください。

参照

データ ソース オブジェクト (OLE DB)