Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

SQL Anywhere 11.0.1 (日本語) » Ultra Light - C/C++ プログラミング » API リファレンス » Ultra Light C++ API リファレンス

 

ul_synch_info_a 構造体

同期データを記述するために使用される構造体です。

構文
public ul_synch_info_a
プロパティ
名前 説明
additional_parms const char *

「キーワード=値」のペアがセミコロンで区切られたリストとして指定された、追加の同期パラメータの文字列です。通常このフィールドには、使用頻度の低い同期パラメータが入ります。Additional Parameters 同期パラメータを参照してください。

auth_parms char **

Mobile Link イベントの認証パラメータの配列です。

auth_status ul_auth_status

Mobile Link のユーザ認証のステータスです。Mobile Link サーバが、この情報をクライアントに提供します。

auth_value ul_s_long

カスタム Mobile Link のユーザ認証スクリプトの結果です。Mobile Link サーバが、この情報をクライアントに提供し、認証ステータスを判断できるようにします。

download_only ul_bool

現在の同期中は、Ultra Light データベースから変更をアップロードしません。

ignored_rows ul_bool

無視されたローのステータスです。同期中にスクリプトがないために Mobile Link サーバによってローが 1 つでも無視されると、この読み込み専用フィールドが true をレポートします。

init_verify ul_synch_info_a *

検証を初期化します。

keep_partial_download ul_bool

同期時の通信エラーが原因でダウンロードが失敗すると、このパラメータは、変更をロールバックしないで部分的なダウンロードを保持するかどうかを制御します。

new_password char *

ユーザ名に対する新しい Mobile Link パスワードを指定する文字列です。このパラメータはオプションです。

num_auth_parms ul_byte

Mobile Link イベントの認証パラメータに渡される認証パラメータの数です。

observer ul_synch_observer_fn

同期をモニタするコールバック関数またはイベント・ハンドラへのポインタです。このパラメータはオプションです。

partial_download_retained ul_bool

同期時の通信エラーが原因でダウンロードが失敗すると、このパラメータは、変更をロールバックしないで、ダウンロードされたこの変更が適用されたかどうかを示します。

password char *

ユーザ名に対する既存の Mobile Link パスワードを指定する文字列です。このパラメータはオプションです。

ping ul_bool

Ultra Light クライアントと Mobile Link サーバ間の通信を確認します。このパラメータが true に設定されている場合は、同期は行われません。

publications const char *

同期に含めるデータを示す、パブリケーションをカンマで区切ったリストです。

resume_partial_download ul_bool

失敗したダウンロードを再開します。同期によって変更はアップロードされず、失敗したダウンロードで変更のみがダウンロードされます。

send_column_names ul_bool

アップロード時にカラム名が Mobile Link サーバに送信されるようアプリケーションに指示します。

send_download_ack ul_bool

クライアントからダウンロード確認を提供するかどうかを Mobile Link サーバに指示します。

stream const char *

同期に使用する Mobile Link ネットワーク・プロトコルです。

stream_error ul_stream_error

通信エラー・レポート情報を保持する構造体です。

stream_parms char *

選択されたネットワーク・プロトコルを設定するオプションです。

upload_ok ul_bool

Mobile Link サーバにアップロードされたデータのステータスです。アップロードに成功すると、true をレポートします。

upload_only ul_bool

現在の同期中は、統合データベースから変更をダウンロードしません。これにより、特に低速の通信リンクでは、通信時間を節約できます。

user_data ul_void *

アプリケーション固有の情報を同期 observer で使用できるようにします。このパラメータはオプションです。

user_name char *

Mobile Link サーバがユニークな Mobile Link ユーザを識別するために使用する文字列です。

version char *

Ultra Light アプリケーションは、バージョン文字列により、同期スクリプトのセットから選択できます。

備考

同期パラメータは、Ultra Light データベースと Mobile Link サーバ間の同期の動作を制御します。Stream Type 同期パラメータ、User Name 同期パラメータ、Version 同期パラメータが必要です。これらが設定されていない場合、同期関数はエラー (SQLE_SYNC_INFO_INVALID またはこれと同じもの) を返します。Download Only、Ping、または Upload Only は一度に 1 つのみ指定できます。これらのパラメータが 1 つ以上 true に設定されると、同期関数はエラー (SQLE_SYNC_INFO_INVALID またはこれと同じもの) を返します。