Distributed Tuning Interface Guide (v11)

PvGetDbServerName() (DTI 関数)

名前付きデータベースが存在するサーバーの名前を取得します。

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

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

構文

BTI_API PvGetDbServerName( 
	BTI_LONG           hConnection, 
	BTI_CHAR_PTR       dbName, 
	BTI_ULONG_PTR      pBufSize, 
	BTI_CHAR_PTR       serverName, 
	BTI_SINT_PTR       pIsLocal); 

引数

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

戻り値

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 関数)
PvDisconnect() (DTI 関数)
PvStop() (DTI 関数)


PvGetDbNamesData() (DTI 関数)

PvGetDSN() (DTI 関数)