Distributed Tuning Interface のリファレンス : PvCheckDbInfo()
 
このページをシェアする                  
PvCheckDbInfo()
データベースの整合性をチェックします。
ヘッダー ファイル：catalog.h（ヘッダー ファイルも参照）
関数が最初に利用可能になるライブラリ：w3dbav75.dll（Windows）、libpsqldti.so（Linux）、libpsqldti.dylib（OS X）（リンク ライブラリも参照）
構文
BTI_API PvCheckDbInfo(
   BTI_LONG       hConnection,
   BTI_CHAR_PTR   dbName,
   BTI_ULONG      checkFlags);
引数
In
hConnection
サーバーを識別する接続ハンドル。接続ハンドルは PvConnectServer() 関数によって取得されます。
In
dbName
既存の名前付きデータベース名。特定サーバーの名前付きデータベースの全リストは、PvGetDbNamesData() 関数を使って取得できます。結果リストから 1 つの名前付きデータベースを取得するには、PvGetDbName() 関数を使用します。
In
checkFlags
予約済み関数はすべてのデータベース フラグをチェックします。
戻り値
P_OK
操作は成功しました。
P_E_INVALID_HANDLE
サーバーを識別する接続ハンドルが無効です。
P_E_NULL_PTR
関数はヌル ポインターによって呼び出されました。
P_E_ACCESS_RIGHT
関数を呼び出すのに十分なアクセス権がありません。
P_E_NOT_EXIST
dbName で指定された名前付きデータベースは存在しません。
P_E_FAIL
一般エラーが発生しました。
備考
データベースに一貫性がある場合、この関数の戻り値は P_OK になります。データベースに一貫性がない場合、または関数呼び出しが失敗した場合、戻り値は上に挙げたエラー コードのいずれかになります。
例
BTI_WORD     res;         // 関数呼び出しから返される値
BTI_CHAR_PTR dbName;      // データベース名
BTI_ULONG    checkFlags;  // データベース フラグ
BTI_LONG     hConnection; // 接続ハンドル
BTI_LONG     reserved;    // PvStart() および PvStop() 用に予約されている値
 
  // 変数を初期化する
dbName = "demodata";
  // データベースの名前は「demodata」
checkFlags = 0xFFFFFFFF;   // すべてのフラグをチェックする
hConnection = P_LOCAL_DB_CONNECTION;
  // 接続ハンドルをローカル接続に設定する
 
  // P_LOCAL_DB_CONNECTION は config.h に定義されている
reserved = 0;
 
  // DTI 呼び出しを実行する前に、DTI セッションを開始する
res = PvStart (reserved);
 
if (res == P_OK)
{
    // DTI セッションは正常に開始されました
    // これで、さまざまな DTI 呼び出しを実行できます
 
    res = PvCheckDbInfo (hConnection,
                         dbName,
                         checkFlags);
 
    if (res == P_OK)
    {
        // データベースは整合しています
    }
    else
    {
        // ここに、PvCheckDbInfo() から返されたエラー コード
        // を処理するコードを記述します
    }
    // DTI セッションを閉じる
    Res = PvStop (&reserved);
}
関連項目
PvStart()
PvConnectServer()
PvGetDbNamesData()
PvGetDbName()
PvFreeDbNamesData()
PvDisconnect()
PvStop()