|
名前付きデータベースが存在するサーバーの名前を取得します。
ヘッダー ファイル: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 以外を返します。
|
以下の前提条件を満たす必要があります。
PvStart() (DTI 関数)
PvConnectServer() (DTI 関数)
PvGetDbNamesData() (DTI 関数)
PvGetDbName() (DTI 関数)
PvDisconnect() (DTI 関数)
PvStop() (DTI 関数)
|