Bool scs_isremotenewer(), Enablers, Bool scs_canconnect() – Adobe Dreamweaver API Reference CS5 User Manual
Page 105

100
DREAMWEAVER API REFERENCE
The source control integration API
Last updated 8/27/2013
•
The noteLength argument is the length of the largest Design note for the specified file or folder.
Returns
A Boolean value:
true
if successful;
false
otherwise.
bool SCS_IsRemoteNewer()
Description
This function checks each specified remote path to see if the remote copy is newer. If it is unsupported by the source
control system, Dreamweaver uses its internal
isRemoteNewer
algorithm.
Arguments
void *connectionData, const char *remotePathList[], const char *localPathList[], int remoteIsNewerList[], const int
numItems
•
The connectionData argument is a pointer to the agent’s data that passed into Dreamweaver during the
Connect()
call.
•
The remotePathList argument is a list of remote filenames or folder paths to compare for newer status.
•
The localPathList argument is a mirrored list of local filenames or folder paths.
•
The remoteIsNewerList argument is a list of integers that are populated by the DLL to let Dreamweaver know which
of the corresponding files is newer on the remote side. The following values are valid: 1 indicates the remote version
is newer; -1 indicates the local version is newer; 0 indicates the versions are the same.
•
The numItems argument is the number of items in each list.
Returns
A Boolean value:
true
if successful;
false
otherwise.
Enablers
If the optional enablers are not supported by the source control system or the application is not connected to the server,
Dreamweaver determines when the menu items are enabled, based on the information it has about the remote files.
bool SCS_canConnect()
Description
This function returns whether the Connect menu item should be enabled.
Arguments
None.
Returns
A Boolean value:
true
if successful;
false
otherwise.