この関数は、古いバージョンのXLA用に作成されたXLAアプリケーションを新しいバージョンで動作させるために、ttXlaSetVersionと組み合せて使用します。通常、configured versionが古いバージョンで、actual versionが新しいバージョンです。
ttXlaGetVersionは、現在構成されているXLAのバージョンを取得して、configuredVersionパラメータに格納します。基礎となるXLAの実際のバージョンはactualVersionに格納されます。ttXlaSetVersionをコールしたため、コールごとにconfiguredVersionの結果が異なる場合がありますが、actualVersionの結果は同じままです。
この関数の使用方法については、「永続または非永続のXLAモード」を参照してください。
SQLRETURN ttXlaGetVersion(ttXlaHandle_h handle,
out ttXlaVersion_t *configuredVersion,
out ttXlaVersion_t *actualVersion)
パラメータ | 型 | 説明 |
handle | ttXlaHandle_h | データ・ストアのトランザクション・ログ・ハンドル。 |
configuredVersion | out ttXlaVersion_t * | 構成されているXLAのバージョン。 |
actual version | out ttXlaVersion_t * | XLAの実際のバージョン。 |
コールが成功すると、SQL_SUCCESSが返されます。返されない場合は、ttXlaErrorを使用してエラーをレポートします。
この例では、次の指示を想定しています。
ttXlaVersion_t configured, actual;
現行のバージョン構成を確認するには、次のコールを実行します。
rc = ttXlaGetVersion(xlahandle, &configured, &actual);