Distributed Tuning Interface Guide (v11)

PvCreateDSN() (DTI 関数)

新しいエンジンのデータ ソース名(DSN)を作成します。

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

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

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

構文

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

引数

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

戻り値

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_FAIL
データ パスの検索に失敗しました。

備考

この関数はエンジン DSN のみ作成します。クライアント DSN を作成するには、ODBC API を使用する必要があります

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

関連項目

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


PvCreateDictionary() (DTI 関数)

PvCreateDSN2() (DTI 関数)