DWC_GdbGetRecordsAsync

構文

#include <dwc.h>
DWCGdbError DWC_GdbGetRecordsAsync(const char *table_name,
                                   const int *record_ids,
                                   int record_num,
                                   const char **field_names,
                                   int field_num,
                                   DWCGdbGetRecordsCallback callback,
                                   void *user_param);

引数

table_name テーブルの名前
record_ids 取得したいレコードのレコードIDの配列
record_num record_idsの要素数
field_names 取得したいフィールド名の配列
field_num field_namesの要素数
callback レコードを受け取るコールバック
user_param コールバックに渡される任意の値

返り値

エラーの内容

説明

指定したレコードIDのレコードを取得する非同期処理を開始します。

処理が成功すると、引数callbackで指定したコールバック関数が呼ばれ、引数record_idsで指定したレコードIDのレコードを受け取ることができます。処理が失敗した場合はコールバックが呼ばれませんのでご注意ください。

返値としてDWC_GDB_ERROR_NONEが返された場合は、非同期処理が開始しています。DWC_GdbGetState関数がDWC_GDB_STATE_IN_ASYNC_PROCESSを返さなくなくなるまで待ってください。

処理の結果は、DWC_GdbGetAsyncResult関数で取得できます。

簡易データベースライブラリの非同期処理は、通信の切断等により、稀にいつまでたっても終わらなくなる可能性がありますので、必ずアプリケーションでタイムアウトを設定するようにして下さい。

履歴

5.1pr2より前の変更履歴はこちら