Distributed Tuning Interface Guide (v11)

PvGetDbDataPath() (DTI 関数)

名前付きデータベースのデータ パス(データ ファイルが保存されている場所)を取得します。この情報は dbnames.cfg に格納されています。

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

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

構文

BTI_API PvGetDbDataPath( 
	BTI_LONG           hConnection, 
	BTI_CHAR_PTR       dbName, 
	BTI_ULONG_PTR      pBufSize, 
	BTI_CHAR_PTR       dataPath); 

引数

In
hConnection
サーバーを識別する接続ハンドル。接続ハンドルは PvConnectServer() (DTI 関数)関数によって取得されます。
In
dbName
データベース名。特定サーバーのデータベース名の全リストは、PvGetDbNamesData() (DTI 関数)関数を使って取得できます。結果リストから 1 つのデータベース名を取得するには、PvGetDbName() (DTI 関数)関数を使用します。
In/Out
pBufSize
バッファーのサイズを格納する符号なし Long 型のアドレス。返されるパスの実際のサイズを受け取ります。
Out
dataPath
成功した場合はデータ パスが格納され、失敗した場合は空文字列が格納されます。

戻り値

P_OK
操作は成功しました。
P_E_INVALID_HANDLE
接続ハンドルが無効です。
P_E_NULL_PTR
ヌル ポインターによる呼び出しです。
P_E_BUFFER_TOO_SMALL
文字列に対しバッファーが小さすぎます。この場合、必要なバッファー サイズが pBufSize に返されます。
P_E_NOT_EXIST
名前付きデータベースは存在しません。
P_E_FAIL
その他の理由により失敗しました。

備考

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

関連項目

PvStart() (DTI 関数)
PvConnectServer() (DTI 関数)
PvGetDbNamesData() (DTI 関数)
PvGetDbName() (DTI 関数)
PvGetDbDictionaryPath() (DTI 関数)
PvGetDbServerName() (DTI 関数)
PvDisconnect() (DTI 関数)
PvStop() (DTI 関数)


PvGetDbCodePage() (DTI 関数)

PvGetDbDictionaryPath() (DTI 関数)