適合 性
導入されたバージョン:ODBC 3.81 規格準拠:ODBC
Summary
SQLSetConnectInfo は、アプリケーションの SQLConnect コールの接続情報トークンにデータソース、ユーザーID、パスワードを設定するために使用されます。
構文
SQLRETURN SQLSetConnectInfo(
SQLHDBC_INFO_TOKEN TokenHandle,
WCHAR * ServerName,
SQLSMALLINT NameLength1,
WCHAR * UserName,
SQLSMALLINT NameLength2,
WCHAR * Authentication,
SQLSMALLINT NameLength3 );
引数
トークンハンドル
[入力]トークンハンドル。
ServerName
[入力]データソース名。 データは、プログラムと同じコンピューターにあったり、ネットワーク上のどこか別のコンピューターにあったりします。 アプリケーションがどのようにデータソースを選択するかについては、「 データソースまたはドライバーの選択」を参照してください。
NameLength1
[入力]*ServerName の文字数。
UserName
[入力]ユーザー識別子。
NameLength2
[入力]*ユーザー名 (文字数)の長さ。
Authentication
[入力]認証文字列(通常はパスワード)。
NameLength3
[入力]*文字数での認証 時間。
返品
SQL_SUCCESS、SQL_SUCCESS_WITH_INFO、SQL_ERROR、またはSQL_INVALID_HANDLE。
Diagnostics
入力検証エラーに関してはSQLConnectと同様に、ドライバーマネージャーはSQL_HANDLE_DBC_INFO_TOKENのHandleTypeとhDbcInfoTokenのハンドルを使用します。
Remarks
ドライバーがSQL_ERRORまたはSQL_INVALID_HANDLEを返すたびに、ドライバーマネージャーはエラーをアプリケーション( SQLConnect または SQLDriverConnect)に返します。
ドライバーがSQL_SUCCESS_WITH_INFOを返すたびに、ドライバーマネージャーは hDbcInfoTokenから診断情報を取得し、 SQLConnect および SQLDriverConnectでSQL_SUCCESS_WITH_INFOをアプリケーションに返します。
アプリケーションはこの関数を直接呼び出すべきではありません。 ドライバー認識接続プーリングをサポートするODBCドライバーはこの機能を実装しなければなりません。
ODBCドライバー開発のためにsqlspi.hを含めてください。