Distributed Tuning Interface Guide (v11)

PvDropDatabase() (DTI 関数)

dnames.cfg から指定されたエントリを削除します。

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

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

構文

BTI_API PvDropDatabase( 
	BTI_LONG        hConnection, 
	BTI_CHAR_PTR    dbName, 
	BTI_CHAR        option); 

引数

In
hConnection
サーバーを識別する接続ハンドル。接続ハンドルは PvConnectServer() (DTI 関数)関数によって取得されます。
In
dbName
データベース名。特定サーバーのデータベース名の全リストは、PvGetDbNamesData() (DTI 関数)関数を使って取得できます。結果リストから 1 つのデータベース名を取得するには、PvGetDbName() (DTI 関数)関数を使用します。
In
option
オプションを示すビットマスクです。データ ファイルを削除したい場合は、ファイル名に加えて下位ビットに 1(0001h)を設定します。そうしない場合、データベース名は削除されますがデータおよび DDF ファイルは残ります。

戻り値

P_OK
操作は成功しました。
P_E_INVALID_HANDLE
接続ハンドルが無効です。
P_E_NULL_PTR
ヌル ポインターによる呼び出しです。
P_E_ACCESS_RIGHT
操作を実行するための十分なアクセス権がありません。
P_E_NOT_EXIST
名前付きデータベースは存在しません。
P_E_FAIL
その他の理由により失敗しました。

備考

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

関連項目

PvStart() (DTI 関数)
PvConnectServer() (DTI 関数)
PvCreateDatabase() (DTI 関数)
PvModifyDatabase() (DTI 関数)
PvDisconnect() (DTI 関数)
PvStop() (DTI 関数)


PvDisconnectSQLConnection() (DTI 関数)

PvDropGroup() (DTI 関数)