GetFTPExistingFilesAction

 

#include “BlackIceDEVMODE.h”

 

BOOL            GetFTPExistingFilesAction (BlackIceDEVMODE* pDevMode, DWORD dwConnectionID, int* iValue);

Description

Gets the Existing Files Action property of the stored FTP connection identified by dwConnectionID. This property specifies what should happen if a file with the same name as the uploaded file, already exists on the server.

Parameters

BlackIceDEVMODE* pDevMode

Pointer to the BlackIceDEVMODE structure.

 

DWORD dwConnectionID

The ID of the connection. The ID can be attained by using the GetFTPConnectionByIndex, GetFTPConnectionByName, GetSelectedFTPConnection or the AddFTPConnection functions.

 

int* iValue

Pointer to a variable that will receive the property. The returned value can be one of the values from the FTPExistingFileAction enum:

enum FTPExistingFileAction
{
            FTP_EXISTING_OVERWRITE_ALL = 0,
                        // 0 – Always overwrite existing files
            FTP_EXISTING_OVERWRITE_SIZE,
                        // 1 – Existing files with different size are to be overwritten
            FTP_EXISTING_OVERWRITE_OLDER,
                        // 2 - Existing files are to be overwritten if they are older than
                        // source files. This is strongly discouraged because modification
                        // dates are often misreported by FTP and SFTP server, making
                        // this mode highly unreliable.
            FTP_EXISTING_RENAME,
                        // 3 - Existing files are to be renamed according the pattern
                        // "filename[number].extension".
            FTP_EXISTING_RESUME,
                        // 4 - Existing files are to be resumed if they are smaller than
                        // source files.
            FTP_EXISTING_SKIP_ALL
                        // 5 - Existing files are to be always skipped
};

Return value

TRUE on success, otherwise FALSE.

Programming Notes

None

Code Example

None