22.1.1 ead_init_client()(EADsクライアントの初期設定)
(1) 機能
クライアント定義に従って,EADsクライアントの初期設定をします。
EADsクライアント名は空文字列として扱います。
また,キャッシュを管理するキャッシュマネージャのハンドル(ポインタ)を取得します。
ead_init_client()を実行するたびに,クラスタを監視するスレッドが1つ生成されます。生成されたスレッドは,ead_terminate_client()実行時に終了します。
(2) 形式
#include <eads.h> EAD_CACHE_MANAGER *ead_init_client ( const char *filename, /* In */ int *error_code /* Out */ );
(3) 引数
- filename
-
EADsクライアントのクライアント定義ファイルのパスを指定します。
- error_code
-
エラーコード取得先のポインタを指定します。
エラーコードについては,「22.2 クライアントライブラリのエラーコード(C言語)」を参照してください。
(4) 戻り値
ead_init_client()が正常に終了した場合は,キャッシュを管理するキャッシュマネージャのハンドル(ポインタ)が返却されます。
ead_init_client()が異常終了した場合は,NULLが返却されます。
(5) 注意事項
-
EADsクライアントを同一マシンで複数同時に実行する場合は,それぞれ異なるログ出力先を指定してください。同一のログ出力先を指定した場合,動作は保証されません。ログ出力先の設定については,「8.4.2 ファイルの出力先の設定」を参照してください。
-
初期設定したEADsクライアントを終了する場合は,必ずead_terminate_client()を実行してください。