SQLConnectEx() 関数

SQL 認証で「ユーザー名とパスワード」タイプの資格情報を使用する場合、SQLConnectEx() 関数を InTouch QuickScript で使用して、ConnectString 引数で指定されたデータベースに接続できます。

SQLConnectEx() は、すべての後続 SQL 関数でパラメータとして使用される ConnectionID 引数に値を返します。SQLConnectEx() 関数をスクリプトで使用する前に、アプリケーション フォルダでバインド リストを定義する必要があります。

カテゴリ

SQL

構文

[ResultCode=]SQLConnectEx(ConnectionID, "ConnectString", "Credential Name");

引数

ConnectionID

各データベース接続に SQLConnectEx() 関数によって割り当てられた番号（ID）を保持するメモリ整数型タグの名前

ConnectString

データベースおよび SQLConnectEx() 関数で使用される追加ログオン情報を識別する文字列

資格情報名

資格情報マネージャに保存された資格情報の名前スタンドアロン InTouch アプリケーションの場合、資格情報はアプリケーション マネージャから取得されます。マネージド InTouch アプリケーションの場合、資格情報は Application Server の資格情報マネージャから取得されます。

備考

アプリケーション フォルダにバインド リスト（SQL.DEF ファイル）が必要です。この関数は、このファイルがないと機能しません。

SQLTrace=1 が win.ini ファイルの [InTouch] セクションに定義されている場合は、SQLConnectEx() が正常に実行されるたびに、ADO、プロバイダ、およびデータベース システムのバージョン情報が Log Viewer に記録されます。

例

次のステートメントは、IBM OS/2 Database Manager と SAMPLE という名前のデータベースに接続します。

[ResultCode=]SQLConnectEx(ConnectionID,"DSN=OS2DM;
DB=SAMPLE");

この関数は、すべての後続 SQL 関数でパラメータとして使用される ConnectionID 変数に値が返されます。

"DSN=data source name[;attribute=value
[;attribute=value]...]"