SQLDriverConnect
SQL Server Native Client ODBC ドライバでは、接続文字列のキーワードを置き換えたり、拡張するための接続属性を定義します。接続文字列のいくつかのキーワードには、SQL Server Native Client ODBC ドライバが指定する既定値があります。
SQL Server Native Client ODBC ドライバで使用できるキーワードの一覧については、「SQL Server Native Client での接続文字列キーワードの使用」を参照してください。
SQL Server の接続属性とドライバの既定の動作の詳細については、「SQLSetConnectAttr」を参照してください。
SQLDriverConnect の DriverCompletion パラメータ値が SQL_DRIVER_PROMPT、SQL_DRIVER_COMPLETE、または SQL_DRIVER_COMPLETE_REQUIRED の場合、SQL Server Native Client ODBC ドライバは、表示されるダイアログ ボックスからキーワード値を取得します。接続文字列でキーワード値が渡され、ユーザーがダイアログ ボックスでキーワードの値を変更しなかった場合、SQL Server Native Client ODBC ドライバは接続文字列の値を使用します。接続文字列で値が設定されていない場合、ユーザーがダイアログ ボックスで割り当てを行わないと、ドライバは既定値を使用します。
DriverCompletion 値によってドライバの接続ダイアログ ボックスの表示が要求されている場合、または要求できる場合、SQLDriverConnect に有効な WindowHandle を指定する必要があります。無効なハンドルを指定すると、SQL_ERROR が返されます。
DRIVER キーワードまたは DSN キーワードを指定します。ODBC は、これらの 2 つのキーワードが両方指定されている場合、左側に指定されているキーワードを使用し、他方を無視するように指示します。DRIVER が指定されているとき、または DRIVER が 2 つのキーワードの左側に指定されているときに、SQLDriverConnect の DriverCompletion パラメータ値が SQL_DRIVER_NOPROMPT の場合、SERVER キーワードに適切な値を指定する必要があります。
SQL_DRIVER_NOPROMPT が指定されているときは、ユーザー認証に関するキーワードに値が指定されている必要があります。ドライバは、文字列 "Trusted_Connection=yes" または UID キーワードと PWD キーワードの両方が指定されていることを確認します。
DriverCompletion パラメータ値が SQL_DRIVER_NOPROMPT または SQL_DRIVER_COMPLETE_REQUIRED で、言語やデータベースを接続文字列から取得するときに、言語またはデータベースの値が無効の場合は、SQLDriverConnect は SQL_ERROR を返します。
DriverCompletion パラメータ値が SQL_DRIVER_NOPROMPT または SQL_DRIVER_COMPLETE_REQUIRED で、言語やデータベースを ODBC データ ソース定義から取得するときに、言語またはデータベースの値が無効の場合は、SQLDriverConnect は指定したユーザー ID の既定の言語または既定のデータベースを使用し、SQL_SUCCESS_WITH_INFO を返します。
DriverCompletion パラメータ値が SQL_DRIVER_COMPLETE または SQL_DRIVER_PROMPT で、言語またはデータベースが無効の場合、SQLDriverConnect はダイアログ ボックスを再表示します。
SQLDriverConnect によるサービス プリンシパル名 (SPN) のサポート
入力要求が有効になっている場合は、SQLDDriverConnect で [ODBC ログイン] ダイアログ ボックスが使用されます。これにより、プリンシパル サーバーとそのフェールオーバー パートナーの両方に対して SPN を入力できます。
SQLDriverConnect で、新しい接続文字列キーワードである ServerSPN および FailoverPartnerSPN を使用できます。また、新しい接続属性である SQL_COPT_SS_SERVER_SPN および SQL_COPT_SS_FAILOVER_PARTNER_SPN が認識されます。
接続属性の値が複数指定されている場合は、DSN の値や接続文字列の値より、プログラムによって設定された値が優先されます。DSN の値は接続文字列の値より優先されます。
接続が開いている場合、SQL Server Native Client では、SQL_COPT_SS_MUTUALLY_AUTHENTICATED および SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD が、接続を開くときに使用された認証方式に設定されます。
SPN の詳細については、「クライアント接続におけるサービス プリンシパル名 (SPN) (ODBC)」を参照してください。
例
次の呼び出しは、SQLDriverConnect に最低限必要なデータを示しています。
SQLDriverConnect(hdbc, hwnd,
(SQLTCHAR*) TEXT("DRIVER={SQL Server Native Client 10};"), SQL_NTS, szOutConn,
MAX_CONN_OUT, &cbOutConn, SQL_DRIVER_COMPLETE);
次の接続文字列は、DriverCompletion パラメータ値が SQL_DRIVER_NOPROMPT の場合に、最低限必要なデータを示しています。
"DSN=Human Resources;Trusted_Connection=yes"
"FILEDSN=HR_FDSN;Trusted_Connection=yes"
"DRIVER={SQL Server Native Client 10};SERVER=(local);Trusted_Connection=yes"