Distributed Tuning Interface Guide (v11)

PvCreateDSN2() (DTI 関数)

新しいエンジンのデータ ソース名(DSN)を作成し、データのエンコード オプションを指定します。

ヘッダー ファイル:catalog.h(ヘッダー ファイルも参照)

関数が最初に利用可能になるライブラリ:w3dbav90.dll(Windows)、libpsqldti.so(Linux)(リンク ライブラリも参照)

この関数を Pervasive PSQL v11 以降のバージョンで使用することは推奨されません。クライアント DSN の作成には ODBC API を使用してください(Linux の場合は dsnadd ユーティリティ)。

構文

BTI_API PvCreateDSN2( 
	BTI_LONG        hConnection, 
	BTI_CHAR_PTR   pdsnName, 
	BTI_CHAR_PTR   pdsnDesc, 
	BTI_CHAR_PTR   pdsnDBQ, 
	BTI_LONG       openMode, 
	BTI_LONG       translate); 

引数

In
hConnection
サーバーを識別する接続ハンドル。接続ハンドルは PvConnectServer() (DTI 関数)関数によって取得されます。
In
pdsnName
新しい DSN 名。
In
pdsnDesc
新しい DSN の説明。
In
pdsnDBQ
この DSN が接続するデータベース名。これは既存の名前でなければなりません。データベース名の作成方法は、PvCreateDatabase() (DTI 関数)を参照してください。
In
openMode
DSN のオープン モード。次のいずれか 1 つになります。
  • NORMAL_MODE
  • ACCELERATED_MODE
  • READONLY_MODE
  • EXCLUSIVE_MODE
SQL Engine Reference』の 「DSN オープン モード」も参照してください。
In
translate
データのエンコード オプション。次のいずれか 1 つになります。
  • DSNFLAG_DEFAULT
  • DSNFLAG_OEMANSI
  • DSNFLAG_AUTO
SQL Engine Reference』の「エンコード変換」も参照してください。DSNFLAG_DEFAULT は ODBC アドミニストレーターでエンコード オプション[なし]に該当します。

戻り値

P_OK
操作は成功しました。
P_E_INVALID_HANDLE
接続ハンドルが無効です。
P_E_NULL_PTR
ヌル ポインターによる呼び出しです。
P_E_INVALID_NAME
指定された DSN 名は無効です。
P_E_DSN_ALREADY_EXIST
指定された DSN 名は既に存在します。
P_E_ACCESS_RIGHT
操作を実行するための十分なアクセス権がありません。
P_E_INVALID_OPEN_MODE
指定されたオープン モードは無効です。
P_E_INVALID_TRANSLATE_OPTION
指定されたエンコード変換オプションが不正です。
P_E_FAIL
データ パスの検索に失敗しました。

備考

この関数はエンジン DSN のみ作成するもので、Pervasive PSQL v10 クライアント以降が必要です。クライアント DSN を作成するには、ODBC API を使用する必要があります(Linux の場合は、dsnadd ユーティリティを使用して クライアント DSN を作成することもできます)。

以下の前提条件を満たす必要があります。

関連項目

PvStart() (DTI 関数)
PvConnectServer() (DTI 関数)
PvListDSNs() (DTI 関数)
PvModifyDSN() (DTI 関数)
PvGetDSN() (DTI 関数)
PvGetDSNEx() (DTI 関数)
PvDeleteDSN() (DTI 関数)
PvCountDSNs() (DTI 関数)
PvStop() (DTI 関数)


PvCreateDSN() (DTI 関数)

PvCreateGroup() (DTI 関数)