Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.
同期を実行するよう、dbmlsync サーバーに要求します。
public virtual DBSC_SyncHdl Sync( const char * profile_name, const char * extra_opts )
profile_name 同期のオプションを含む同期プロファイルの名前で、リモートデータベース内に定義されているもの。profile_name が NULL の場合、プロファイルは使用されないため、extra_opts パラメーターに、同期に使用するすべてのオプションが指定されている必要があります。
extra_opts 同期プロファイルのオプション文字列を定義するときと同じルールに従った形式の文字列。<オプション名>=<オプション値> 形式のエレメントのセミコロンで区切ったリストとして指定される文字列です。profile_name が NULL 以外の場合、extra_opts で指定したオプションは、profile_name で指定した同期プロファイルにすでにあるオプションに追加されます。プロファイルに文字列のオプションがすでに存在する場合は、プロファイルにすでに格納済みの値が文字列の値に置き換わります。profile_name が NULL の場合、extra_opts に、同期に使用するすべてのオプションが指定されている必要があります。CREATE SYNCHRONIZATION PROFILE 文 [Mobile Link]を参照してください。
この同期要求をユニークに識別する DBSC_SyncHdl 値を返します。この値は、クライアントがサーバーから切断するまでの間でのみ有効です。エラーのために同期要求を作成できなかった場合は NULL_SYNCHDL を返します。NULL_SYNCHDL が返されたときは、GetErrorInfo メソッドを呼び出して、失敗に関する詳細な情報を取得できます。
サーバーに接続してから、このメソッドを呼び出してください。profile_name と extra_opts のうち少なくとも 1 つを NULL 以外の値にしてください。
戻り値は同期要求を識別し、要求のキャンセルや同期によって返されるイベントの処理に使用できます。