iscEngineOpen()

目的

iscEngineOpen() は、同期エンジンへのハンドルをオープンします。

構文

isy_INT32 iscEngineOpen(
    HISCCONF     hConf,
    HISCENG     *phEngine);

関数の引き数

表 135 は、iscEngineOpen() 関数で使用される有効な引き数をリストしたものです。

表 135. iscEngineOpen() の引き数

データ・タイプ	引き数	用途	説明
HISCCONF	`hConf`	入力	構成ハンドル
HISCENG*	`phEngine`	出力	同期エンジンへのハンドル

使用法

iscEngineOpen() は、指定された構成を同期化する際に、同期エンジン (HISCENG) へのハンドルをオープンするために使用します。同期化が正常に終了すると、ハンドルが *phEngine を介して戻されます。同期化が正常に終了しなかった場合、*phEngine 値は NULL となり、エラー・コードが戻されます。

戻りコード

ISCRTN_Succeeded: 正常
ISCRTN_OutOfMemory: メモリー不足
ISCRTN_ResourceBusy: リソースがロック状態である (例えば、別のアプリケーションなどによって)
ISCRTN_NotPermitted: リソースにアクセス不能である (例えば、リソースが読み取り不可の場合など)
ISCRTN_NotFound: リソースが見つからない (例えば、パスが見つからない場合など)
ISCRTN_Failed: その他

制約事項

iscEngineOpen() を複数回呼び出すと、同期エンジンへの複数のハンドルがオープンして整合性に関する問題が発生する可能性があるため、複数回呼び出さないようにしてください。

関連した概念

同期クライアント C/C++ サンプル・アプリケーション

関連したタスク

C/C++ を使用した DB2 Everyplace 同期クライアント・アプリケーションの開発

関連した解説