ul_synch_info_w2 構造体

同期を記述するために使用されるワイド文字構造体です。

構文

public ul_synch_info_w2

プロパティ

名前	型	説明
additional_parms	const ul_wchar *	「キーワード=値」のペアがセミコロンで区切られたリストとして指定された、追加の同期パラメータの文字列です。通常このフィールドには、使用頻度の低い同期パラメータが入ります。Additional Parameters 同期パラメータを参照してください。
auth_parms	ul_wchar **	Mobile Link イベントの認証パラメータの配列です。
auth_status	ul_auth_status	Mobile Link のユーザ認証のステータスです。Mobile Link サーバが、この情報をクライアントに提供します。
auth_value	ul_s_long	Mobile Link サーバが、この情報をクライアントに提供し、認証ステータスを判断できるようにします。
download_only	ul_bool	現在の同期中は、Ultra Light データベースから変更をアップロードしません。
ignored_rows	ul_bool	無視されたローのステータスです。同期中にスクリプトがないために Mobile Link サーバによってローが 1 つでも無視されると、この読み込み専用フィールドが true をレポートします。
init_verify	ul_synch_info_w2 *	検証を初期化します。
keep_partial_download	ul_bool	同期時の通信エラーが原因でダウンロードが失敗すると、このパラメータは、変更をロールバックしないで部分的なダウンロードを保持するかどうかを制御します。
new_password	ul_wchar *	ユーザ名に対する新しい Mobile Link パスワードを指定する文字列です。このパラメータはオプションです。
num_auth_parms	ul_byte	Mobile Link イベントの認証パラメータに渡される認証パラメータの数です。
observer	ul_synch_observer_fn	同期をモニタするコールバック関数またはイベント・ハンドラへのポインタです。このパラメータはオプションです。
partial_download_retained	ul_bool	同期時の通信エラーが原因でダウンロードが失敗すると、このパラメータは、変更をロールバックしないで、ダウンロードされたこの変更が適用されたかどうかを示します。
password	ul_wchar *	ユーザ名に対する既存の Mobile Link パスワードを指定する文字列です。このパラメータはオプションです。
ping	ul_bool	Ultra Light クライアントと Mobile Link サーバ間の通信を確認します。このパラメータが true に設定されている場合は、同期は行われません。
publications	const ul_wchar *	同期に含めるデータを示す、パブリケーションをカンマで区切ったリストです。
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	ul_wchar *	選択されたネットワーク・プロトコルを設定するオプションです。
upload_ok	ul_bool	Mobile Link サーバにアップロードされたデータのステータスです。アップロードに成功すると、true をレポートします。
upload_only	ul_bool	現在の同期中は、統合データベースから変更をダウンロードしません。これにより、特に低速の通信リンクでは、通信時間を節約できます。
user_data	ul_void *	アプリケーション固有の情報を同期 observer で使用できるようにします。このパラメータはオプションです。
user_name	ul_wchar *	Mobile Link サーバがユニークな Mobile Link ユーザを識別するために使用する文字列です。
version	ul_wchar *	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 またはこれと同じもの) を返します。ul_synch_info_a 構造体を参照してください。