// size, in bytes, of this structure [no default]

// version number of this structure, use the largest version number defined in FVSDK_Session.h, [must be FVSDK_SESSION_CURRENT_VERSION]

// the unique session number used by the DLL [no default]

typedef WORD FVSDK_SESSION_ID;

// the last error number [FVSDK_OK]

typedef int FVSDK_ERROR_CODE;

// can be NULL, but should be a handle to the application's main window when using user interface options [NULL]

// the name of the application using the FVSDK, used in certain dialog box titles [NULL]

// the version number of your application, used by FVSDK when sending servers the CLNT command [NULL]

// use PASV mode (instead of PORT mode) [FALSE]

// NULL to use the Windows defined temporary directory, otherwise the full path to a local directory

// maintain the dates and times of downloaded files [TRUE]

// maintain the dates and times of uploaded files, will NOT work with all servers [TRUE]

// convert files dated in the future to the correct year; For example, UNIX usually doesn't include the year [TRUE]

// convert dates and times to local time assuming the server dates and times are in GMT (when connecting to UNIX style servers). [TRUE]

// convert all files names to upper case when uploading [FALSE]

// convert all file names to lower case when uploading [FALSE]

// convert all upper case file names to lower case when uploading [FALSE]

// converts the first character to upper case when uploading [FALSE]

// use thorough UNIX link resolution, attempting CWD commands on UNIX links to determine if the item is a file or directory [TRUE]

// use ASCII mode [FALSE]

// use Automatic ASCII mode, pszTextFileExtensions must be set [FALSE]

// use UNIX style listings when connected to an MVS server [FALSE]

// change the local file's date and time to the uploaded file's date and time when unable to maintain the uploaded file's date and time [FALSE]

// automatic upload setting to use when using the FVSDK_RemoteEdit() function [FVSDK_AUTO_UPLOAD_ASK]

FVSDK_AUTO_UPLOAD_ASK	ask the user to upload a changed file while using FVSDK_RemoteEdit() or FVSDK_RemoteView()
FVSDK_AUTO_UPLOAD_AUTOMATIC	don't ask the user to upload a changed file while using FVSDK_RemoteEdit() or FVSDK_RemoteView(), upload it if it's changed
FVSDK_AUTO_UPLOAD_DISABLED	don't do anything using using FVSDK_RemoteEdit() or FVSDK_RemoteView() after the user completes his work

// password security mode to use, if requested by server: none, MD4, or MD5; both MD4 and MD5 are automatic if needed. Values are defined in FVSDK_Session.h [FVSDK_PASSWORD_MD5]

FVSDK_PASSWORD_REGULAR	use only regular passwords
FVSDK_PASSWORD_MD4	use only MD4 S/Key passwords, when requested by server
FVSDK_PASSWORD_MD5	use MD4 or MD5 S/Key passwords, when requested by server

// No Security, SSL Explicit (AUTH SSL command is sent), SSL Implicit, TLS Explicit (AUTH TLS command is sent), or SFTP Using SSH2; constants found in FVSDK_Session.h [FVSDK_ST_REGULAR]

FVSDK_ST_REGULAR	regular, clear text FTP
FVSDK_ST_SSL_EXPLICIT	start with regular FTP, send AUTH SSL to go to SSL mode after connecting
FVSDK_ST_SSL_IMPLICIT	start with SSL, usually on port 990
FVSDK_ST_TLS_EXPLICIT	start with regular FTP, send AUTH TLS to go to TLS mode after connecting
FVSDK_ST_SSH	SFTP using SSH2, contact RhinoSoft.com for more information

// enable blocking on file transfers, uses a single connection instead of two to transfer a file [TRUE]

// FALSE to disable checking for resume support on the server [TRUE]

// FALSE to disable the use of the FEAT command; some servers disconnect when an unrecognized command is sent [TRUE]

// force use of NLST instead of LIST or MLST / MLSD [FALSE]

// send the CCC command after starting SSL; the data channel remains encrypted [FALSE]

// use a clear, unencrypted data channel when using SSL [FALSE]

// use MLST / MLSD instead of LIST when the server supports these commands [TRUE]

// display transfer errors that may occur [FALSE]

// login without attempting to discover information about the server. When TRUE, FEAT, SYST, CWD, PWD, etc. will not be sent to the server after connecting. Setting to TRUE will cause the bSupportsResume and bSupportsFEAT values to be ignored. [FALSE]

// NULL for none, set to a comma separated string for include filtering (i.e., "*.exe,*.txt,*.htm,*.html") [NULL]

// NULL for none, set to a comma separated string for exclude filtering (i.e., "_vti*,*.tmp,*.temp,*.bin") [NULL]

// include folders when applying filters [TRUE]

// apply filters to uploads [TRUE]

// apply filters to downloads [TRUE]

// apply filters to server-to-server transfers [TRUE]

// apply filters to Synchronize Folders [TRUE]

// the number of attempts to make when downloading a file [1]

// the number of attempts to make when uploading a file [1]

// use the XCRC command to verify the contents of a transferred file [TRUE]

// limit the upload rate to dUploadRate [FALSE]

// limit the download rate to dDownloadRate [FALSE]

// limit upload transfers to this value (KB/sec) [10]

// limit download transfers to this value (KB/sec) [10]

// compression mode, as found in FVSDK_Session.h [FVSDK_DSCMP_AUTOMATIC]

FVSDK_DSCMP_DISABLED	compression is off
FVSDK_DSCMP_AUTOMATIC	automatically determine if compression can be used
FVSDK_DSCMP_ZLIB	force zLib compression

// 1 - 9. 1 is least compression and lowest CPU cycles; 9 is the highest compression but more CPU cycles [6]

// automatically rename files matching ppszUploadRenames on upload [FALSE]

// NULL terminated array of strings for auto rename on upload [NULL]

// automatically rename files matching ppszDownloadRenames on download [FALSE]

// NULL terminated array of strings for auto rename on download [NULL]

// delete files downloaded to temporary directory when finished editing [TRUE]

// extra parameters to use with LIST command, such as "-al" and "-alT" [NULL]

// minutes to offset from GMT [0]

// automatically adjust dates and times from GMT, see constants found in FVSDK_Session.h for possible values [FVSDK_GMT_ADJUST_AUTO]

FVSDK_GMT_ADJUST_AUTO	automatically adjust for the server's time zone when appropriate
FVSDK_GMT_ADJUST_NONE	don't adjust for the server's time zone
FVSDK_GMT_ADJUST_MINUTE_OFFSET	use nMinuteOffsetGMT to adjust the time offset on the server

// remove VMS version numbers from the end of file names [TRUE]

// remove MVS extensions from file names [TRUE]

// NULL terminated string representing a "profile name" like FTP Voyager uses for Site Profiles, this is descriptive only [NULL]

// time, in milliseconds, to wait before timing out a connection attempt [60 * 1000]

// the number of times to reconnect upon a command failure [2]

// the number of times to retry the initial connection [3]

// time, in milliseconds, to wait on a request to receive data before cancelling the request [60 * 1000]

// time, in milliseconds, to wait on a request to send data before cancelling the request [60 * 1000]

// enable keep alive functionality [TRUE]

// time, in seconds, between issuing keep alive commands [30]

// time, in milliseconds, to wait between reconnect attempts (connection throttling) [5 * 1000]

// show pop-up transfer dialogs while transferring files [FALSE]

// enable transfer animations [TRUE]

// NULL for none, or a pointer to a string containing the full path to the .AVI file [NULL]

// NULL for none, or a pointer to a string containing the full path to the .AVI file [NULL]

// NULL for none, or a pointer to a string containing the full path to the .AVI file [NULL]

// NULL for none, or a pointer to a string containing the full path to the .AVI file [NULL]

// NULL for none, full path name to a .WAV file to play when done connecting to a site [NULL]

// NULL for none, full path name to a .WAV file to play when done transferring a file [NULL]

// NULL for none, comma separated string of text file extensions used for AUTO ASCII mode, see defaults found in FVSDK_Session.h [DEFAULT_TEXT_FILES]

// proxy server to use for connecting, see nAccessType constants found in FVSDK_Session.h [FVSDK_AT_DIRECT]

FVSDK_AT_SITE	use SITE site
FVSDK_AT_DIRECT	direct to net
FVSDK_AT_USER_AFTER_LOGON	USER, PASSWORD to proxy, then USER=user@site to site
FVSDK_AT_OPEN	use OPEN site
FVSDK_AT_SOCKS4	SOCKS4 Proxy Server
FVSDK_AT_SOCKS5	SOCKS5 Proxy Server
FVSDK_AT_SOCKS4A	SOCKS4a Proxy Server
FVSDK_AT_FIREUSERID_AT_SITE_PORT	USER fireID@remoteHost
FVSDK_AT_HTTP	HTTP Proxy Server
FVSDK_AT_USERID_AT_SITE	USER userid@site
FVSDK_AT_USERID_AT_SITE_COLON_PORT	USER userid@site:21
FVSDK_AT_USERID_AT_SITE_SPACE_PORT	USER userid@site 21
FVSDK_AT_USERID_AT_SITE_SPACE_PROXY_NAME	USER userid@site proxy_name_or_IP

// pointer to the proxy name or IP address, must resolve to an IP address [NULL]

// NULL if no user ID is required by the proxy, otherwise a string containing the proxy server user ID [NULL]

// the proxy server port number, defaults: SOCKS is 1080, user@... is 21, etc. [21]

// NULL if no password is required by the proxy, otherwise a string containing the proxy server password [NULL]

// usually '@', representing the user @ proxy server type ['@']

// enable upload confirmation messages when overwriting an existing file on the server [TRUE]

// enable download confirmation messages when overwriting an existing local file [TRUE]

// enable upload confirmation messages when overwriting a file when automatically uploading a file using online editing [TRUE]

// enable confirmation messages when attempting to delete a file [TRUE]

// enable confirmation messages when attempting to delete a folder and its contents [TRUE]

// enable confirmation messages when attempting to delete a folder short cut [TRUE]

// upload newer local files only (i.e., when uploading in batch) [FALSE]

// download newer remote files only (i.e., when downloading in batch) [FALSE]

// use PWD in addition to NOOP when issuing keep alive commands [FALSE]

// either a resolvable server name or IP address [NULL]

// the port number of the server, normally 21 for standard FTP, 990 for Implicit SSL, 22 for SFTP using SSH2 [21]

// user ID to use when logging in, NULL for none [anonymous]

// password to use when logging in, NULL for none [NULL]

// the default "initial" directory, NULL for none [NULL]

// NULL for none, string containing an account name for login to a server [NULL]

// NULL for the default, or a string containing a password to use when logging in anonymously [NULL]

// return raw directory listings with the server's response [FALSE]

// NULL for none, or the full path to the certificate file [NULL]

// NULL for none, or the full path to the private key file [NULL]

// NULL for none, or the specified certificate's password [NULL]

// use password authentication with SSH [FALSE]

// use public key authentication with SSH [FALSE]

// use compression with SSH [TRUE]

// NULL for none, or the password for the private key [NULL]

// NULL for none, or the path to the private key file [NULL]

// use only the ports starting with dwPortRangeStart through dwPortRangeEnd for PORT commands [FALSE]

// when bUsePortRange is TRUE, the starting port range to use [2000]

// when bUsePortRange is TRUE, the starting port range to use [2050]

// NULL for none, or the public IP address or domain name to use when providing the IP address with the PORT command [NULL]

// the DOD entry to use when dialing [NULL]

// the user ID to use when dialing [NULL]

// the password to use when dialing [NULL]

// the NT domain to connect to when dialing, NULL for none [NULL]

// the number of times to try to successfully connect using DOD [1]

// the phone number to use for callbacks [NULL]

// use the add-ons defined in ppszAddOns [FALSE]

// NULL terminated array of strings (full paths to an add-on DLL) [NULL]

// callback function to use for logging commands, responses, status, and errors; see types listed in FVSDK_Session.h

typedef void (CALLBACK* FVSDK_LOG_TEXT_FUNC) (FVSDK_CALLBACK_DATA pvData, UINT nType, LPCTSTR pszText);

typedef void* FVSDK_CALLBACK_DATA;

// callback function when server asks for a password; return TRUE and set pszBuffer to the password, FALSE to terminate the connection

typedef BOOL (CALLBACK* FVSDK_ASKPASS_FUNC) (FVSDK_CALLBACK_DATA pvData, LPCTSTR pszBuffer, int nBufferSize);

typedef void* FVSDK_CALLBACK_DATA;

// callback function when server asks for a password to be changed; return TRUE and set pszBuffer to the new password, FALSE to terminate the connection

typedef BOOL (CALLBACK* FVSDK_ASKPASSC_FUNC) (FVSDK_CALLBACK_DATA pvData, LPCTSTR pszBuffer, int nBufferSize);

typedef void* FVSDK_CALLBACK_DATA;

// callback function when the password has been changed for the user ID on the server

typedef void (CALLBACK* FVSDK_PASSCHG_FUNC) (FVSDK_CALLBACK_DATA pvData, LPCTSTR pszPassword);

typedef void* FVSDK_CALLBACK_DATA;

// callback function used when a file has been renamed after upload; the original and new file names are passed as paramters

typedef void (CALLBACK* FVSDK_FLUP_REN_FUNC) (FVSDK_CALLBACK_DATA pvData, LPCTSTR pszOldFileName, LPCTSTR pszNewFileName);

typedef void* FVSDK_CALLBACK_DATA;

// callback function used when a file has been uploaded using FVSDK_Upload(); both the source and destination paths are the parameters

typedef void (CALLBACK* FVSDK_FLUP_FUNC) (FVSDK_CALLBACK_DATA pvData, LPCTSTR pszSourcePath, LPCTSTR pszDestPath);

typedef void* FVSDK_CALLBACK_DATA;

// callback function used when a file has been downloaded using FVSDK_Download(); both the source and destination paths are the parameters

typedef void (CALLBACK* FVSDK_FLDOWN_FUNC) (FVSDK_CALLBACK_DATA pvData, LPCTSTR pszSourcePath, LPCTSTR pszDestPath);

typedef void* FVSDK_CALLBACK_DATA;

// callback function used when a download error occurs using FVSDK_Download(); errors defined in FtpTreeErrors.h

typedef void (CALLBACK* FVSDK_FLDNERR_FUNC) (FVSDK_CALLBACK_DATA pvData, long nErr, long nCause, LPCTSTR pszError, LPCTSTR pszRemotePath, LPCTSTR pszDestFileName, LPCTSTR pszExtraInfo);

typedef void* FVSDK_CALLBACK_DATA;

// callback function used when an upload error occurs using FVSDK_Upload(); errors defined in FtpTreeErrors.h

typedef void (CALLBACK* FVSDK_FLUPERR_FUNC) (FVSDK_CALLBACK_DATA pvData, long nErr, long nCause, LPCTSTR pszError, LPCTSTR pszRemotePath, LPCTSTR pszLocalPath);

typedef void* FVSDK_CALLBACK_DATA;

// callback function used when a local directory has been created

typedef void (CALLBACK* FVSDK_LCDIRCR_FUNC) (FVSDK_CALLBACK_DATA pvData, LPCTSTR pszPath);

typedef void* FVSDK_CALLBACK_DATA;

// callback function used when a local file or directory is deleted

typedef void (CALLBACK* FVSDK_LCDIRDL_FUNC) (FVSDK_CALLBACK_DATA pvData, LPCTSTR pszPath);

typedef void* FVSDK_CALLBACK_DATA;

// callback function used when a local file is changed

typedef void (CALLBACK* FVSDK_LCFLCHG_FUNC) (FVSDK_CALLBACK_DATA pvData, LPCTSTR pszPath);

typedef void* FVSDK_CALLBACK_DATA;

// callback function used when a remote directory is created; the parameter is the full path to the remote directory

typedef void (CALLBACK* FVSDK_RMDIRCR_FUNC) (FVSDK_CALLBACK_DATA pvData, LPCTSTR pszPath);

typedef void* FVSDK_CALLBACK_DATA;

// callback function used when a remote directory is deleted; the parameter is the full path to the remote directory

typedef void (CALLBACK* FVSDK_RMDIRDEL_FUNC) (FVSDK_CALLBACK_DATA pvData, LPCTSTR pszPath);

typedef void* FVSDK_CALLBACK_DATA;

// callback function used when a remote file is deleted; the parameter is the full path to the remote file

typedef void (CALLBACK* FVSDK_RMFILEDL_FUNC) (FVSDK_CALLBACK_DATA pvData, LPCTSTR pszPath);

typedef void* FVSDK_CALLBACK_DATA;

// callback function used when the user presses the help button in an FVSDK dialog (Sync Folders, Find Files, or Online Edit)

typedef void (CALLBACK* FVSDK_HELP_FUNC) (FVSDK_CALLBACK_DATA pvData, UINT nSource);

typedef void* FVSDK_CALLBACK_DATA;

// callback function used when the transfer status changes; see FVSDK_TransferStatus.h for more information

typedef void (CALLBACK* FVSDK_TRANSTAT_FUNC) (FVSDK_CALLBACK_DATA pvData, UINT nStatus, FVSDK_TransferStatus* pStatus);

typedef void* FVSDK_CALLBACK_DATA;