Distributed Tuning Interface Guide (v11)

PvGetDbNamesData() (DTI 関数)

接続されたサーバーのデータベース名の数を取得します。名前を列挙するには、PvGetDbName() (DTI 関数)関数を使用します。

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

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

構文

BTI_API PvGetDbNamesData( 
	BTI_LONG           hConnection, 
	BTI_ULONG_PTR      pCount); 

引数

In
hConnection
サーバーを識別する接続ハンドル。接続ハンドルは PvConnectServer() (DTI 関数)関数によって取得されます。
Out
pCount
サーバー上のデータベース名の数を受け取るための符号なし Long 型のアドレス。

戻り値

P_OK
操作は成功しました。
P_E_INVALID_HANDLE
接続ハンドルが無効です。
P_E_NULL_PTR
ヌル ポインターによる呼び出しです。
P_E_FAIL
その他の理由により失敗しました。

備考

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

この関数は、データベース名の情報を取得するほかの関数よりも先に呼び出される必要があります。呼び出し元は PvFreeDbNamesData() (DTI 関数)を呼び出して、データベース名に割り当てられたリソースを解放する必要があります。

関連項目

PvStart() (DTI 関数)
PvConnectServer() (DTI 関数)
PvGetDbName() (DTI 関数)
PvFreeDbNamesData() (DTI 関数)
PvDisconnect() (DTI 関数)
PvStop() (DTI 関数)


PvGetDbName() (DTI 関数)

PvGetDbServerName() (DTI 関数)