SQLDriverConnect

[アーティクル]
12/15/2008

SQL Native Client ODBC ドライバでは、接続文字列のキーワードを置き換えたり、拡張するための接続属性を定義します。接続文字列のいくつかのキーワードには、SQL Native Client ODBC ドライバが指定する既定値があります。

SQL Native Client ODBC ドライバで使用できるキーワードの一覧については、「SQL Native Client での接続文字列キーワードの使用」を参照してください。

SQL Server の接続属性とドライバの既定の動作の詳細については、「SQLSetConnectAttr」を参照してください。

SQLDriverConnect の DriverCompletion パラメータ値が SQL_DRIVER_PROMPT、SQL_DRIVER_COMPLETE、または SQL_DRIVER_COMPLETE_REQUIRED の場合、SQL Native Client ODBC ドライバは、表示されるダイアログボックスからキーワード値を取得します。接続文字列でキーワード値が渡され、ユーザーがダイアログボックスでキーワードの値を変更しないと、SQL 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 に最低限必要なデータを示しています。

SQLDriverConnect(hdbc, hwnd,
    (SQLTCHAR*) "DRIVER={SQL Native Client};" SQL_NTS, szOutConn,
    MAX_CONN_OUT, &cbOutConn, SQL_DRIVER_COMPLETE);

次の接続文字列は、DriverCompletion パラメータ値が SQL_DRIVER_NOPROMPT の場合に、最低限必要なデータを示しています。

"DSN=Human Resources;UID=MyUserName;PWD=MyPassword"

"DSN=Human Resources;Trusted_Connection=yes"

"FILEDSN=HR_FDSN;UID=MyUserName;PWD=MyPassword"

"FILEDSN=HR_FDSN;Trusted_Connection=yes"

"DRIVER={SQL Native Client};SERVER=(local);UID=MyUserName;PWD=MyPassword"

"DRIVER={SQL Native Client};SERVER=(local);Trusted_Connection=yes"

参照

SQLDriverConnect

例

参照

概念

その他の技術情報

ヘルプおよび情報

その他のリソース