SetFTPExistingFilesAction

#include “BlackIceDEVMODE.h”

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

Description

Sets 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

The new value of the property. The 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