Distributed Tuning Interface Guide (v11)

PvModifyDSN2() (DTI 関数)

既存のデータ ソース名を変更します。この関数は、データのエンコード オプションが指定されることを除けば、PvModifyDSN() (DTI 関数)とまったく同じです。

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

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

この関数を Pervasive PSQL v11 以降のバージョンで使用することは推奨されません。クライアント DSN を使った作業には、ODBC API を使用してください。

構文

BTI_API PvModifyDSN( 
	BTI_LONG        hConnection, 
	BTI_CHAR_PTR    dsnName, 
	BTI_CHAR_PTR    dsnDesc, 
	BTI_CHAR_PTR    dsnDBQ, 
	BTI_LONG        openMode, 
	BTI_LONG        translate); 

引数

In
hConnection
サーバーを識別する接続ハンドル。接続ハンドルは PvConnectServer() (DTI 関数)関数によって取得されます。
In
dsnName
変更する DSN の名前。
In
dsnDesc
DSN の新しい説明。
In
dsnDBQ
DSN の新しいデータベース名。
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_DSN_DOES_NOT_EXIST
指定された DSN 名は存在しません。
P_E_ACCESS_RIGHT
操作を実行するための十分なアクセス権がありません。
P_E_INVALID_OPEN_MODE
指定されたオープン モードは無効です。
P_E_INVALID_TRANSLATE_OPTION
指定されたエンコード変換オプションが不正です。
P_E_FAIL
データ パスの検索に失敗しました。

備考

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

関連項目

PvConnectServer() (DTI 関数)
PvCountDSNs() (DTI 関数)
PvCreateDatabase2() (DTI 関数)
PvCreateDSN2() (DTI 関数)
PvDeleteDSN() (DTI 関数)
PvGetDSN() (DTI 関数)
PvGetDSNEx2() (DTI 関数)
PvListDSNs() (DTI 関数)
PvStart() (DTI 関数)
PvStop() (DTI 関数)


PvModifyDSN() (DTI 関数)

PvOpenDatabase() (DTI 関数)