Sync method

Request that the dbmlsync server perform a synchronization.

Syntax
UInt32 Sync( string profile_name, string extra_opts )
Remarks

You must be connected to the server before calling this method.

At least one of syncName and opts must be non-null.

Parameters
  • profile_name   The name of a synchronization profile defined in the remote database that contains the options for the synchronization. If syncName is null then no profile is used and the extra_opts parameter should contain all the options for the synchronization.

  • extra_opts   A string formed according to the same rules used to define an option string for a synchronization profile. The options specified in the string are added to those already in the synchronization profile specified by profile_name. If an option in the string already exists in the profile then the value from the string replaces the value already stored in the profile. If profile_name is null, then extra_opts should specify all the options for the synchronization.

Returns

Returns an integer value which uniquely identifies this synchronization request. The returned value is only valid until the client disconnects from the server.

Returns NULL_SYNCHDL if an error prevents the synchronization request from being created. When this happens, you can call the GetErrorInfo method to get more information about the failure. See GetErrorInfo method.