PvCreateDSN()

このページをシェアする

PvCreateDSN()

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

ヘッダーファイル：catalog.h（「ヘッダーファイル」も参照）

関数が最初に利用可能になるライブラリ：w3dbav78.dll（Windows）、libpsqldti.so（Linux）、libpsqldti.dylib（macOS）（「リンクライブラリ」も参照）

この関数を Zen v11 以降のバージョンで使用することは推奨されません。クライアント DSN の作成には ODBC API を使用してください（Linux および macOS の場合は 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() 関数によって取得されます。
In	pdsnName	新しい DSN 名。
In	pdsnDesc	新しい DSN の説明。
In	pdsnDBQ	この DSN が接続するデータベース名。これは既存の名前でなければなりません。データベース名の作成方法は、PvCreateDatabase() を参照してください。
In	openMode	DSN のオープンモード。次のいずれか 1 つになります。 •NORMAL_MODE •ACCELERATED_MODE •READONLY_MODE •EXCLUSIVE_MODE

戻り値

備考

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

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

•PvStart() 呼び出しによって DTI セッションが開始されている。

•PvConnectServer() によって接続が確立している。ただし、ローカルマシンで操作を実行する場合は、接続ハンドルとして P_LOCAL_DB_CONNECTION を使用できます。

•pdsnDBQ パラメーターで参照されるデータベース名は既に存在している。データベース名の作成方法は、PvCreateDatabase() を参照してください。