Adobe 38040334 API Reference - Page 93

DREAMWEAVER CS3 88 API Reference 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 isFolder month day year hour minutes seconds type size char[256] bool int int int int int int char[256] int Name of file or folder true if folder; false if file Month component of modification date 1-12 Day component of modification date 1-31 Year component of modification date 1900+ Hour component of modification date 0-23 Minute component of modification date 0-59 Second component of modification date 0-59 Type of file (if not set by DLL, Dreamweaver uses file extensions to determine type, as it does now) In bytes • The numItems argument is the number of items that are allocated for the itemList (returned from GetFolderListLength).