|
シーケンス番号を使って、接続されたサーバーのデータベース名を取得します。データベース名の番号は、PvGetDbNamesData() (DTI 関数)関数を呼び出すことによって取得できます。シーケンス番号は 1 基準です。
ヘッダー ファイル:catalog.h(「ヘッダー ファイル」も参照)
関数が最初に利用可能になるライブラリ:w3dbav75.dll(Windows)、libpsqldti.so(Linux)(「リンク ライブラリ」も参照)
BTI_API PvGetDbName( BTI_LONG hConnection, BTI_ULONG sequence, BTI_ULONG_PTR pBufSize, BTI_CHAR_PTR dbName);
In
|
hConnection
|
サーバーを識別する接続ハンドル。接続ハンドルは PvConnectServer() (DTI 関数)関数によって取得されます。
|
In
|
sequence
|
データベース名のシーケンス番号(1 基準)。PvGetDbNamesData() (DTI 関数)によって定義される値を上限とした、有効な範囲内の番号でなければなりません。
|
In/Out
|
pBufSize
|
データベース名を取得するために割り当てられたバッファーのサイズを格納する、符号なし Long 型のアドレス。コピーされた文字の実際のサイズを受け取ります。サイズにはヌル終端文字を含める必要があります。
|
Out
|
dbName
|
返された文字列値。
|
BTI_ULONG i; BTI_ULONG count = 0; BTI_CHAR dbName[BDB_SIZE_DBNAME+1]; BTI_SINT status = PvGetDbNamesData(connection, &count); for (i=1; i<= count; i++) { BTI_ULONG dbNameSize = sizeof(dbName); status = PvGetDbName(connection, i, &dbNameSize, dbName); } status = PvFreeDbNamesData(connection);
以下の前提条件を満たす必要があります。
PvStart() (DTI 関数)
PvConnectServer() (DTI 関数)
PvGetDbNamesData() (DTI 関数)
PvFreeDbNamesData() (DTI 関数)
PvDisconnect() (DTI 関数)
PvStop() (DTI 関数)
|