User Guide

122 The Source Control Integration API
int SCS_GetFolderListLength()
Description
This function returns the number of items in the passed-in folder.
Arguments
void *connectionData, const char *remotePath
■ The connectionData argument is a pointer to the agent’s data that passed into
Dreamweaver during the
Connect() call.
■ The remotePath argument is the full path and name of the remote folder that the DLL
checks for the number of items.
Returns
An integer that indicates the number of items in the current folder. If the function returns <
0
, Dreamweaver considers it an error and tries to retrieve the error message from the DLL,
if supported.
bool SCS_GetFolderList()
Description
This function returns a list of files and folders in the passed-in folder, including pertinent
information such as modified date, size, and whether the item is a folder or file.
Arguments
void *connectionData, const char *remotePath, itemInfo itemList[ ], const
int numItems
■ The connectionData argument is a pointer to the agent’s data that passed into
Dreamweaver during the
Connect() call.
■ The remotePath argument is the path of the remote folder that the DLL checks for the
number of items.
■ The itemList argument is a preallocated list of itemInfo structures:
name char[256] Name of file or folder
isFolder
bool true if folder; false if file
month
int Month component of modification date 1-12
day
int Day component of modification date 1-31
year
int Year component of modification date 1900+
000_DW_API_Print.book Page 122 Wednesday, July 20, 2005 11:58 AM