Ftp2

Set to True to request cancellation of the operation currently running on this object. Long-running network and file-transfer methods periodically check this property; methods that complete quickly may finish before the request is observed.

A synchronous call can be cancelled from another thread by setting this property on the same object. The property is reset to False after cancellation is processed, and a stale request is cleared when a later method begins.

Specifies the FTP account string sent with the ACCT command when a server requires an account in addition to the username and password.

See the notes about PWideChar memory ownership and validity.

Specifies the last local TCP port that may be used for active-mode data connections. The default is 0. Valid nonzero values are 1 through 65535.

The range beginning with ActivePortRangeStart is inclusive. If ActivePortRangeStart is 0, this property is ignored and the operating system chooses an ephemeral listening port. If this value is 0 or is less than ActivePortRangeStart, Chilkat behaves as though both endpoints equal ActivePortRangeStart.

Unavailable ports are skipped. Chilkat tries each port in the effective range until binding succeeds, and fails only after all ports have been tried. The range applies to both PORT and EPRT and may be changed while the control connection is already established.

Specifies the first local TCP port that may be used for active-mode data connections. The default is 0. Valid nonzero values are 1 through 65535.

When this property is 0, ActivePortRangeEnd is ignored and Chilkat binds the listening socket to port 0, allowing the operating system to choose an available ephemeral port. When this property is nonzero, the effective range is inclusive. If the ending value is 0 or is less than the starting value, Chilkat tries only the starting port.

For each active-mode data connection, Chilkat tries the ports in the effective range in ascending order, skipping any port for which the listening socket cannot be bound. The operation fails only after every port in the range has been tried.

Specifies the size, in bytes, to send in an ALLO command before the next applicable upload. For example, a value of 20 sends ALLO 20. The default value of 0 disables the command.

This is a one-shot setting. It is consumed by the next applicable upload and automatically reset to 0. It applies to normal, in-memory, text, and append uploads. A successful FTP reply indicating that allocation is unnecessary, such as reply code 202, does not prevent the upload from continuing.

Controls whether machine-readable directory listings are requested with MLSD when the server advertises support. The default is True.

When this property is True and MLSD is advertised, Chilkat uses MLSD. Otherwise, a legacy listing is used: NLST when PreferNlst is True, or LIST when it is False.

MLSD provides standardized facts such as type, size, and modification time and is generally more reliable than parsing server-specific LIST output. Facts not supplied by the server remain unavailable. When a perm fact is present, GetPermissions returns it rather than a UNIX-style permission string.

The TLS upgrade is completed before USER and PASS are sent. ConnectOnly performs the explicit TLS upgrade but does not log in. During Connect, Chilkat sends PBSZ and PROT as required by DataProtection. If the server responds with 530 Please login with USER and PASS, Chilkat logs in and automatically retries those commands.

If the server accepts the AUTH command but rejects a required PBSZ or PROT command, the connection attempt fails. A failed connection attempt does not leave the underlying plain FTP connection open.

AUTH SSL is the alternative explicit-TLS command used by this property. If Ssl is True, implicit TLS takes priority. If both this property and AuthTls are True while Ssl is False, AuthTls takes priority and Chilkat sends AUTH TLS.

Set to True to use explicit FTP over TLS by sending AUTH TLS on the FTP control channel. The client first establishes a plain FTP control connection, receives the server greeting, and then upgrades that connection to TLS. Port 21 is conventionally used.

The TLS upgrade is completed before USER and PASS are sent. ConnectOnly performs the explicit TLS upgrade but does not log in. During Connect, Chilkat sends PBSZ and PROT as required by DataProtection. If the server responds with 530 Please login with USER and PASS, Chilkat logs in and automatically retries those commands.

If the server accepts the AUTH command but rejects a required PBSZ or PROT command, the connection attempt fails. A failed connection attempt does not leave the underlying plain FTP connection open.

If Ssl is True, implicit TLS takes priority and this property is ignored. If both AuthTls and AuthSsl are True while Ssl is False, AuthTls takes priority.

When AutoSyst is also True, automatic SYST is sent first. If UTF8 is advertised and AutoOptsUtf8 is True, capability processing is followed by OPTS UTF8 ON.

The same capability processing can be performed later by calling Feat explicitly.

Controls automatic adjustment of Ssl, AuthSsl, and AuthTls based solely on Port. The default is True. The only recognized ports are 21 and 990.

Controls whether Chilkat sends a SIZE command before a download so percentage-based progress can be calculated. The default is False. Each size query adds a control-channel round trip.

A nonzero one-shot value in ProgressMonSize or ProgressMonSize64 supplies the expected size directly and avoids this additional query. Even when this property is False, percentage progress may be available if the server includes a usable size in its preliminary transfer reply.

Controls whether OPTS UTF8 ON is sent automatically when a processed FEAT response advertises UTF8. The default is True. When UTF-8 is advertised, Chilkat sets CommandCharset and DirListingCharset to utf-8, overwriting values previously assigned by the application.

If UTF8 is not advertised, the existing charset property values are left unchanged. This behavior applies both during automatic capability discovery and when Feat is called explicitly.

Set to False for a server that advertises UTF-8 but rejects the option or uses a different encoding in practice.

The result is based on both the advertised capabilities and the connection context; it is not simply a copy of whether EPSV appears in the FEAT reply. For example, an IPv4 connection may retain UseEpsv = FALSE even when the server advertises EPSV. Automatic recalculation can overwrite an explicitly assigned value, and each new connection recalculates it for the new session.

If an attempted EPSV command is rejected, Chilkat falls back to PASV for that data connection. The failed attempt is not remembered as a session-wide reason to disable future EPSV attempts.

Controls whether a SYST command is sent automatically after login. The default is True. The server's operating-system type can help Chilkat interpret legacy LIST output and other server-specific behavior.

When both this property and AutoFeat are True, automatic SYST occurs before automatic FEAT.

Set to False only when a particular server rejects or mishandles SYST.

Controls automatic post-upload verification with the server-specific XCRC command. The default is False. When enabled and the server supports XCRC, Chilkat requests a CRC after an upload and treats a mismatch as transfer failure.

If XCRC support is not detected, Chilkat does not send the verification command and the upload proceeds normally. This extension is not part of the core FTP standard and is not supported by every server. Capability detection normally depends on a processed FEAT response.

Specifies the approximate maximum download rate in bytes per second. The default value of 0 disables throttling.

Client-side download throttling is approximate because the server continues sending as permitted by TCP. The operating system's socket buffers absorb data between reads, so very small transfers may complete before the configured rate can be meaningfully enforced.

Specifies the approximate maximum upload rate in bytes per second. The default value of 0 disables throttling.

The limit is averaged over the transfer. Very small uploads may complete before the configured rate can be closely approximated.

This property is normally left unset. Set it only on a multihomed computer when the application must bind the outgoing connection to a specific local network interface.

Specify a numeric IPv4 or IPv6 address, not a hostname. When the property is empty, the operating system automatically chooses the local address.

See the notes about PWideChar memory ownership and validity.

Specifies the character encoding used by high-level FTP operations for commands containing non-ASCII text, including remote paths and filenames. The default is ANSI. Charset names and the keyword ANSI are case-insensitive. An unrecognized charset name is clamped to utf-8, and the getter returns utf-8.

Changing this property after connecting affects subsequent high-level FTP commands. If a character cannot be represented in a selected single-byte encoding, the character is omitted from the transmitted command; use utf-8 to preserve full Unicode names.

See the notes about PWideChar memory ownership and validity.

Contains a numeric reason code after Connect or ConnectOnly fails. Use this value for broad classification and inspect LastErrorText for detailed diagnostics.

A successful connection sets this property to 0. An authentication failure can set it to 301 while ConnectVerified remains True, because the TCP and FTP connection succeeded before the login was rejected.

Specifies the maximum number of seconds to wait for a remote endpoint to accept a TCP connection. The default is 30. A value of 0 or any negative value waits indefinitely.

This timeout applies whenever Ftp2 establishes a TCP connection, including the FTP control connection, FTP data connections, and connections to configured proxy servers.

It covers only TCP connection establishment. It does not apply to TLS handshakes, FTP greetings or replies, authentication, file data, or any other communication after the TCP connection has been accepted.

Indicates whether the TCP connection to the FTP server was successfully established during the most recent connection attempt. It does not indicate that FTP authentication succeeded; see LoginVerified.

This is a verification result, not a current-socket-state property. It remains True after Disconnect if the preceding connection was successfully established.

Controls line-ending conversion when downloading in ASCII transfer mode. The default is 0.

Returns the number of bytes received by the current or most recently completed FTP download as a 32-bit unsigned integer. The value is updated while the transfer is in progress and may be read from another thread to display progress. A subsequent upload does not clear the retained download count.

Returns the number of bytes received by the current or most recently completed FTP download as a 64-bit integer. The value is updated while the transfer is in progress and may be read from another thread to display progress. A subsequent upload does not clear the retained download count.

Returns the number of bytes received by the current or most recently completed FTP download as a decimal string. The value is updated while the transfer is in progress and may be read from another thread to display progress. A subsequent upload does not clear the retained download count.

See the notes about PWideChar memory ownership and validity.

Returns the number of bytes sent by the current or most recently completed FTP upload as a 32-bit unsigned integer. The value is updated while the transfer is in progress and may be read from another thread to display progress. A subsequent download does not clear the retained upload count.

Returns the number of bytes sent by the current or most recently completed FTP upload as a 64-bit integer. The value is updated while the transfer is in progress and may be read from another thread to display progress. A subsequent download does not clear the retained upload count.

Returns the number of bytes sent by the current or most recently completed FTP upload as a decimal string. The value is updated while the transfer is in progress and may be read from another thread to display progress. A subsequent download does not clear the retained upload count.

See the notes about PWideChar memory ownership and validity.

Specifies the protection level for FTP data connections. The value is compared case-insensitively. The default is control.

Connect sends the required PBSZ and PROT commands. If the server requires login first and replies with 530 Please login with USER and PASS, Chilkat authenticates and automatically retries them. A required protection setup fails only when no acceptable protection level can be established.

See the notes about PWideChar memory ownership and validity.

If set to a file path, this property logs the LastErrorText of each Chilkat method or property call to the specified file. This logging helps identify the context and history of Chilkat calls leading up to any crash or hang, aiding in debugging.

Enabling the VerboseLogging property provides more detailed information. This property is mainly used for debugging rare instances where a Chilkat method call causes a hang or crash, which should generally not happen.

Possible causes of hangs include:

• A timeout property set to 0, indicating an infinite timeout.
• A hang occurring within an event callback in the application code.
• An internal bug in the Chilkat code causing the hang.

See the notes about PWideChar memory ownership and validity.

Specifies the character encoding used only to decode directory-listing and related server-response bytes. It applies to responses from LIST, NLST, and MLSD. It does not affect commands, remote paths, filenames, usernames, passwords, or other text sent to the server.

The default is ANSI. Charset names and the keyword ANSI are case-insensitive. ANSI means the platform's system-default single-byte encoding or default system locale; on Windows, this is the active code page (ACP).

Using the wrong encoding can produce incorrectly decoded names without causing the listing operation itself to fail. When AutoOptsUtf8 is enabled and UTF-8 support is advertised, Chilkat changes this property to utf-8, even if the application previously assigned another value. If UTF-8 is not advertised, the existing value is left unchanged.

See the notes about PWideChar memory ownership and validity.

Returns the current average download rate in bytes per second. The value is updated during synchronous and asynchronous downloads and describes the download in progress or the most recently completed download. A subsequent upload does not clear the retained download rate.

Controls automatic resolution of credential values from secure operating-system storage. The default is False. When enabled, supported password properties may contain a secret specification beginning with !! instead of the literal password.

!![appName|]service[|domain]|username

Secret specifications are supported by Password, HttpProxyPassword, ProxyPassword, and SocksPassword. Chilkat resolves them through Windows Credential Manager on Windows or Apple Keychain on macOS.

Specifies the IPv4 address advertised to the server for active-mode data connections. This property affects both PORT and EPRT. Supply a numeric IPv4 address, the keyword control, or an IPv4 address prefixed with bind-. IPv6 values are not accepted. Keywords and prefixes are case-insensitive.

• control uses the local IPv4 address of the established FTP control socket.
• bind-192.0.2.10 advertises the address and also binds the local data-listener socket to that address.
• A plain IPv4 address changes the address sent in PORT or EPRT without explicitly binding the listener to that address.

If ClientIpAddress is set, this property should specify the same local address. When a bind- value is used with ActivePortRangeStart and ActivePortRangeEnd, Chilkat binds to the specified address while searching the effective range for an available port.

See the notes about PWideChar memory ownership and validity.

Contains the initial FTP server greeting received for the most recent connection immediately after the TCP or implicit-TLS connection was established. It normally begins with reply code 220 and may include server identification or policy information.

The value remains available after Disconnect.

See the notes about PWideChar memory ownership and validity.

Indicates whether the FTP server advertised support for MODE Z, which compresses FTP data streams using the DEFLATE algorithm.

This property becomes meaningful after Chilkat has processed a successful FEAT response, either automatically because AutoFeat is True or through an explicit call to Feat. Before capability discovery, a value of False does not establish that the server lacks MODE Z support.

Call SetModeZ after connecting to enable or disable compressed transfer mode.

Specifies the interval, in milliseconds, between AbortCheck callbacks during methods that support periodic cancellation checks. The default is 0, which disables these callbacks.

Smaller values can improve cancellation responsiveness but increase callback overhead. Methods that complete quickly may not generate a callback.

Specifies the FTP server hostname or numeric IPv4/IPv6 address. Do not include a URL scheme, path, or port; configure the port separately with Port.

See the notes about PWideChar memory ownership and validity.

Specifies the authentication method used with an HTTP proxy. Supported values are Basic and NTLM. Leave empty when the proxy does not require authentication.

See the notes about PWideChar memory ownership and validity.

Specifies the Windows domain used for NTLM authentication to the HTTP proxy. It is ignored for Basic authentication and may be left empty when the username already includes the required domain information.

See the notes about PWideChar memory ownership and validity.

Specifies the hostname or numeric IP address of an HTTP proxy used to establish the FTP control connection. Leave empty to connect directly.

See the notes about PWideChar memory ownership and validity.

Specifies the password used to authenticate to the HTTP proxy. It is used together with HttpProxyUsername and HttpProxyAuthMethod.

See the notes about PWideChar memory ownership and validity.

Specifies the TCP port of the HTTP proxy. Common values include 8080 and 3128, but the correct value is determined by the proxy configuration.

Specifies the username used to authenticate to the HTTP proxy. Leave empty when the proxy allows unauthenticated connections.

See the notes about PWideChar memory ownership and validity.

Specifies the maximum period, in milliseconds, during which no control-channel response or forward upload progress is observed. The default is 60000. A value of 0 or any negative value waits indefinitely.

During an upload, the same limit applies when the operating-system send buffer remains full because the server is not consuming data.

Deprecated. Indicates whether the object appears to be connected and authenticated. Reading this property may send NOOP to test the session. Use CheckConnection instead.

Controls collection of an in-memory FTP protocol log. When enabled, commands and server replies are available in SessionLog. Use ClearSessionLog to discard previously collected text.

Controls an additional keepalive measure for very long uploads and downloads. The default is False. When enabled, Chilkat sends NOOP on the FTP control channel once per minute while a long-running file transfer is in progress.

This helps prevent the otherwise idle control connection from being closed by the server, a firewall, or a NAT device while file data continues on the separate data connection.

Provides HTML-formatted information about the last called method or property. If a method call fails or behaves unexpectedly, check this property for details. Note that information is available regardless of the method call's success.

See the notes about PWideChar memory ownership and validity.

Provides plain text information about the last called method or property. If a method call fails or behaves unexpectedly, check this property for details. Note that information is available regardless of the method call's success.

See the notes about PWideChar memory ownership and validity.

Provides XML-formatted information about the last called method or property. If a method call fails or behaves unexpectedly, check this property for details. Note that information is available regardless of the method call's success.

See the notes about PWideChar memory ownership and validity.

Indicates the success or failure of the most recent method call: True means success, False means failure. This property remains unchanged by property setters or getters. This method is present to address challenges in checking for null or Nothing returns in certain programming languages. Note: This property does not apply to methods that return integer values or to boolean-returning methods where the boolean does not indicate success or failure.

Contains the most recent FTP control-channel reply, including its three-digit status code and message. Examples include 250 Directory successfully changed. and 550 Failed to change directory.

The value is updated by successful as well as failed commands. After Disconnect, it normally contains the server's reply to QUIT, such as 221 Goodbye.. Some replies are multiline; use this property together with the method return value and LastErrorText when diagnosing a failure.

See the notes about PWideChar memory ownership and validity.

Specifies an option string appended literally to the legacy LIST command, such as -a. For example, setting this property to -a sends LIST -a. Chilkat does not interpret the option locally. It has no effect when AllowMlsd causes MLSD to be used or when PreferNlst causes NLST to be used.

LIST options and output formats are not standardized by FTP. Many UNIX-like servers pass the option to an underlying ls implementation, while other servers may reject or interpret it differently.

See the notes about PWideChar memory ownership and validity.

Specifies the case-insensitive wildcard pattern applied to the cached listing of the current remote directory. The default is *. It affects methods such as GetDirCount, GetFilename, GetIsDirectory, GetSize, and the listing timestamp methods.

Chilkat retrieves the full directory listing and applies this pattern locally; the pattern is not appended to LIST, NLST, or MLSD. For example, *.txt also matches a name such as UPPER.TXT.

Specify only a name pattern, such as *.txt. To list subdir/*.txt, first call ChangeRemoteDir for subdir, then set this property to *.txt.

See the notes about PWideChar memory ownership and validity.

Indicates whether FTP authentication succeeded during the most recent login attempt. A TCP connection may be established even when this property is False; for example, rejected credentials leave ConnectVerified True and this property False.

This is a verification result, not a current-socket-state property. It remains True after Disconnect if the preceding session was successfully authenticated.

Indicates whether the most recent download method received some, but not all, of the remote file. It is False when no data was received or when the complete file was received.

This property helps distinguish a mid-transfer failure from a failure that occurred before any file data arrived.

Selects the FTP data-connection mode. The default is True for passive mode. Set to False for active mode.

Controls how the address returned by PASV is handled. The default is True. When enabled, Chilkat ignores the IP address embedded in the server's PASV reply and connects to the control connection's server address using only the returned port.

This avoids private or otherwise unreachable addresses returned by FTP servers behind NAT, especially when TLS prevents a network device from rewriting the reply.

Specifies the password used for FTP authentication. For anonymous FTP, this is commonly an email address or arbitrary identifying string. Applications that already store the password in a SecureString should use SetSecurePassword instead.

See the notes about PWideChar memory ownership and validity.

Specifies the integer value that represents 100 percent in PercentDone callbacks. The default is 100. For example, a scale of 1000 allows one-tenth-percent resolution, where callback value 453 represents 45.3 percent.

The value is limited to the range 10 through 100000. This property is relevant only in environments that support event callbacks and only for operations whose total work can be measured.

Specifies the FTP server port. Port 21 is conventionally used for plain FTP or explicit FTPS, and port 990 is conventionally used for implicit FTPS.

When AutoFix is True, only these two port numbers cause automatic changes to Ssl, AuthSsl, and AuthTls. A custom port leaves all three TLS-mode properties unchanged.

Controls the preferred address family when DNS resolution returns both IPv4 and IPv6 addresses. The default is False, which prefers IPv4. Set it to True to prefer IPv6.

Controls whether NLST is preferred over LIST when a legacy directory listing is required. The default is False. This property is consulted only when AllowMlsd does not result in MLSD being used.

NLST generally returns names only. Do not rely on indexed sizes, timestamps, ownership, group, or permission information after an NLST listing. Because NLST does not reliably identify entry types, Chilkat may send additional commands, such as directory-change tests, to determine which names are directories.

Specifies the expected size, in bytes, of the next file downloaded by GetFile when the size is not otherwise known. Chilkat uses the value to calculate percentage progress.

This is a one-shot setting. It is consumed by the next applicable download and automatically reset to 0. Set it immediately before the download. When a nonzero value is supplied, Chilkat does not need the additional size query controlled by AutoGetSizeForProgress.

If this property is zero, percentage progress may still be available when the server's preliminary transfer reply includes the file size.

The 64-bit form of ProgressMonSize. Specifies the expected size, in bytes, of the next download when the value may exceed the 32-bit integer range. It is consumed by the next applicable download and automatically reset to 0.

Specifies the hostname or IP address of a traditional FTP application proxy or firewall. This is distinct from an HTTP CONNECT proxy and from a SOCKS proxy. The login sequence is selected by ProxyMethod.

See the notes about PWideChar memory ownership and validity.

Selects the login sequence required by a traditional FTP proxy or firewall. The default is 0, meaning no FTP proxy. Configure ProxyHostname, ProxyPort, and the required proxy credentials before connecting.

USER ProxyUsername
PASS ProxyPassword
SITE Hostname
USER Username
PASS Password

USER Username@Hostname:Port
PASS Password

USER ProxyUsername
PASS ProxyPassword
USER Username@Hostname:Port
PASS Password

USER Username@Hostname:Port ProxyUsername
PASS Password
ACCT ProxyPassword

USER ProxyUsername
PASS ProxyPassword
OPEN Hostname
USER Username
PASS Password

USER ProxyUsername@Hostname
USER Username
PASS Password

USER ProxyUsername
USER ProxyPassword
SITE Hostname:Port
USER Username
PASS Password

USER Username@ProxyUsername@Hostname
PASS Password@ProxyPassword

ProxyUsername
ProxyPassword
Username
Password

Specifies the password used to authenticate to a traditional FTP proxy or firewall. Its placement in the login exchange depends on ProxyMethod.

See the notes about PWideChar memory ownership and validity.

Specifies the TCP port on which the traditional FTP proxy or firewall accepts connections.

Specifies the username used to authenticate to a traditional FTP proxy or firewall. Its placement in the login exchange depends on ProxyMethod.

See the notes about PWideChar memory ownership and validity.

Specifies the maximum number of seconds that a data connection may remain without receiving another byte. The default is 60. A value of 0 or any negative value waits indefinitely.

This is an inactivity timeout, not a limit on total transfer duration. Receiving any data, even a single byte, resets the timer and begins a new full timeout interval. A large download may therefore continue indefinitely as long as data keeps arriving within the configured interval.

Controls verification of the FTP server's TLS certificate chain.

Certificate-chain verification is separate from hostname matching and public-key pinning. Hostname matching, when required, is enforced independently even when this property is False. TlsPinSet supplements rather than replaces normal certificate verification.

The hostname used for the TLS connection is also used for Server Name Indication (SNI) and certificate hostname comparison.

Set to True to request that the next applicable upload or download resume from existing content instead of starting over. Unrelated FTP commands do not consume the setting. The next applicable transfer consumes it and automatically resets it to False.

For a resumed upload, Chilkat obtains the existing remote size, begins reading the local content at that offset, and appends the remaining bytes. For a resumed download, Chilkat uses the existing destination length as the REST offset and appends the remaining remote bytes.

The setting applies to the ordinary file, BinData, and StringBuilder upload and download methods, including PutFile, PutFileBd, PutFileSb, GetFile, GetFileBd, and GetFileSb.

Resume requires compatible server support and a correct partial local or remote file. The application should verify that the existing content belongs to the same file version before resuming.

Contains the in-memory FTP session log collected while KeepSessionLog is True. The log includes protocol commands and server replies and is useful for troubleshooting. Passwords and other sensitive information may appear; handle the text accordingly.

See the notes about PWideChar memory ownership and validity.

Specifies the hostname or IP address of the SOCKS proxy. It is used only when SocksVersion is 4 or 5.

See the notes about PWideChar memory ownership and validity.

Specifies the password for SOCKS5 username/password authentication. It is ignored for SOCKS4, which has no password-authentication field.

See the notes about PWideChar memory ownership and validity.

Specifies the SOCKS proxy port. The default is 1080. It is used only when SocksVersion is 4 or 5.

Specifies the SOCKS user identifier. SOCKS5 may use it with password authentication; SOCKS4 sends it as the protocol user ID. It is used only when SocksVersion is 4 or 5.

See the notes about PWideChar memory ownership and validity.

Selects SOCKS proxy usage.

Specifies the socket receive-buffer size. The default is 4194304 bytes. Normally this property should remain unchanged.

When download throughput is unexpectedly low, testing a larger value may help. Values should generally be multiples of 4096.

Specifies the socket send-buffer size. The default is 262144 bytes. Normally this property should remain unchanged.

When upload throughput is unexpectedly low, testing values such as 524288 or 1048576 may help. Values should generally be multiples of 4096.

Set to True to use implicit FTP over TLS. TLS begins immediately after the TCP connection is established, before the FTP greeting is received. Port 990 is conventionally used for implicit FTPS.

This property has priority over AuthTls and AuthSsl. If Ssl is True, implicit TLS is used even when either explicit-TLS property is also True. ConnectOnly performs the implicit TLS handshake but does not send USER or PASS.

Restricts the cipher suites and selected TLS security requirements offered for FTP TLS connections.

Leave this property empty to allow all cipher suites implemented by the installed Chilkat version. To restrict negotiation, provide a comma-separated list in preference order, for example:

TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384, TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256

The server chooses from the cipher suites offered by the client; the client cannot force a suite the server does not support.

The list may also contain these policy keywords:

• rsa1024 or rsa2048 to require a minimum RSA server-key size.
• secure-renegotiation to require secure TLS renegotiation.
• best-practices to use the security policy recommended by the installed Chilkat version.

Legacy keywords such as aes256-cbc, aes128-cbc, 3des-cbc, and rc4 remain recognized for compatibility, but explicitly listing acceptable suites is preferred.

See the notes about PWideChar memory ownership and validity.

Selects the TLS protocol version or minimum version allowed for secure FTP connections.

The complete list of accepted values is:

default
TLS 1.3
TLS 1.2
TLS 1.1
TLS 1.0
SSL 3.0
TLS 1.3 or higher
TLS 1.2 or higher
TLS 1.1 or higher
TLS 1.0 or higher

The default is default, which allows Chilkat to negotiate a protocol supported by both client and server. A minimum-version setting is generally more interoperable than requiring one exact version.

See the notes about PWideChar memory ownership and validity.

Indicates whether the FTP server certificate chain was successfully verified for the current or most recent TLS connection.

This property reports certificate-chain verification only. It does not report hostname matching or public-key pinning. If hostname matching or TlsPinSet pinning is required and the check fails, the TLS connection itself fails.

Controls whether download synchronization creates empty remote directories on the local filesystem. The default is True. When False, a local directory is created only when it is needed to contain a downloaded file.

Specifies a semicolon-separated list of case-insensitive wildcard patterns for files that are eligible for synchronization and tree operations. For example: *.xml;*.txt;*.csv.

When nonempty, a file must match at least one pattern. Matching is performed against the file's basename, not its relative path. Thus keep.txt can match a file in any traversed subdirectory, while a pattern such as subdir/*.txt does not match a nested relative path.

This filter applies to synchronization methods and also to PutTree, DownloadTree, and DirTreeXml.

See the notes about PWideChar memory ownership and validity.

Specifies a semicolon-separated list of case-insensitive wildcard patterns for directories that synchronization methods are allowed to enter. For example: src;data_*;reports. When nonempty, a directory must match at least one pattern before its contents are traversed.

See the notes about PWideChar memory ownership and validity.

Specifies a semicolon-separated list of case-insensitive wildcard patterns for files that must be excluded from synchronization and tree operations. For example: *.tmp;*.bak;~*.

Matching is performed against the file's basename, not its relative path. Exclusion is applied in addition to SyncMustMatch.

This filter also applies to PutTree, DownloadTree, and DirTreeXml.

See the notes about PWideChar memory ownership and validity.

Specifies a semicolon-separated list of case-insensitive wildcard patterns for directories that synchronization methods must not enter. For example: .git;temp;archive_*. Exclusion is applied in addition to SyncMustMatchDir.

See the notes about PWideChar memory ownership and validity.

Contains the preview produced by SyncRemoteTree2 when ARG4 is True. Each CRLF-delimited line is an absolute local path that would be uploaded if preview mode were disabled.

The value is replaced at the start of each preview operation. It is empty when no files qualify, when the preview fails, or when ARG2 is not a valid synchronization mode. A subsequent non-preview synchronization operation also clears it. Unrelated methods do not clear the most recent preview.

See the notes about PWideChar memory ownership and validity.

Contains the cipher suite negotiated for the current or most recent successful TLS connection, such as TLS_AES_256_GCM_SHA384. It is empty before a TLS session has been established or after a failed attempt that produced no negotiated suite.

See the notes about PWideChar memory ownership and validity.

Specifies one or more expected Subject Public Key Info (SPKI) fingerprints for TLS public-key pinning. If none of the configured pins matches the server certificate, the TLS handshake fails.

Pinning supplements normal certificate-chain verification; it does not replace it. A matching pin does not make an expired or otherwise invalid certificate acceptable. When a pin set is configured, pin matching is enforced even if RequireSslCertVerify is False.

The format is:

hashAlgorithm, encoding, fingerprint1, fingerprint2, ...

Example:

sha256, base64, lKg1SIqyhPSK19tlPbjl8s02yChsVTDklQpkMCHvsTE=

Supported hash algorithms include sha1, sha256, sha384, sha512, md2, md5, haval, ripemd128, ripemd160, ripemd256, and ripemd320. Supported encodings include base64, hex, and other Chilkat-supported binary encodings.

See the notes about PWideChar memory ownership and validity.

Contains the protocol version negotiated for the current or most recent successful TLS connection, such as TLS 1.2 or TLS 1.3. It is empty when no TLS session has been established.

See the notes about PWideChar memory ownership and validity.

Provides a comma-separated list of compatibility options for uncommon platform or server requirements. The default is empty and should normally remain empty.

See the notes about PWideChar memory ownership and validity.

Returns the current average upload rate in bytes per second. The value is updated during synchronous and asynchronous uploads and describes the upload in progress or the most recently completed upload. A subsequent download does not clear the retained upload rate.

Controls whether passive data connections first use EPSV instead of PASV. The default is False. This property has no effect when Passive is False.

If EPSV is rejected, Chilkat automatically retries the data connection using PASV. The rejection does not disable EPSV for the remainder of the session, so a later passive data connection may try EPSV again.

AutoSetUseEpsv can change this property automatically when server capabilities are examined.

Specifies the FTP login name. The default is anonymous. Set it to an empty string to have Connect establish the connection without performing authentication; authentication may then be handled separately with LoginAfterConnectOnly.

See the notes about PWideChar memory ownership and validity.

If set to True, then the contents of LastErrorText (or LastErrorXml, or LastErrorHtml) may contain more verbose information. The default value is False. Verbose logging should only be used for debugging. The potentially large quantity of logged information may adversely affect peformance.

Version of the component/library, such as "10.1.0"

See the notes about PWideChar memory ownership and validity.

Appends the contents of the local file at localFilePath to the remote file at remoteFilePath. Both arguments are paths in their respective local and remote filesystems.

Uses the FTP APPE command. On servers with normal APPE behavior, a missing remote file is created and an existing file is extended. A failed or interrupted append can leave the bytes already accepted by the server in place; the operation is not transactional.

Returns True for success, False for failure.

Creates an asynchronous task to call the AppendFile method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Appends the bytes in the BinData object bd to the remote file at remoteFilename. No text encoding or line-ending conversion is performed.

Uses the FTP APPE command. On servers with normal APPE behavior, a missing remote file is created and an existing file is extended. A failed or interrupted append can leave the bytes already accepted by the server in place; the operation is not transactional.

Returns True for success, False for failure.

Creates an asynchronous task to call the AppendFileBd method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Encodes the text in textData using the character encoding named by charset and appends the resulting bytes to the remote file at remoteFilename.

This method controls the encoding of the file content. The encoding used for the remote filename itself is controlled separately by CommandCharset.

Uses the FTP APPE command. On servers with normal APPE behavior, a missing remote file is created and an existing file is extended. A failed or interrupted append can leave the bytes already accepted by the server in place; the operation is not transactional.

Returns True for success, False for failure.

Creates an asynchronous task to call the AppendFileFromTextData method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Encodes the text in the StringBuilder sb using the charset named by charset and appends the resulting bytes to the remote file at remoteFilename.

Uses the FTP APPE command. On servers with normal APPE behavior, a missing remote file is created and an existing file is extended. A failed or interrupted append can leave the bytes already accepted by the server in place; the operation is not transactional.

Returns True for success, False for failure.

Creates an asynchronous task to call the AppendFileSb method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Changes the current working directory on the FTP server to remoteDirPath. A relative path is resolved from the current remote directory; an absolute path is interpreted according to the server's path syntax.

Chilkat sends one CWD command containing remoteDirPath. It does not split a multi-level path into separate directory changes. A server may accept a path such as a/b/c in one command or may require the application to change one level at a time.

If the CWD command fails, the current remote directory remains unchanged.

Returns True for success, False for failure.

Creates an asynchronous task to call the ChangeRemoteDir method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Returns whether Chilkat currently considers the FTP control connection to be open. It does not require that the session be authenticated: it can return True after ConnectOnly and before LoginAfterConnectOnly.

This is a local connection-state check. It does not send NOOP, reconnect automatically, or prove that a silently broken network path will carry the next command.

Returns True for success, False for failure.

Creates an asynchronous task to call the CheckConnection method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Requests that an explicit-FTPS control connection return to clear text after authentication. Data connections may remain protected according to DataProtection.

Returns True for success, False for failure.

Creates an asynchronous task to call the ClearControlChannel method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Clears the cached listing for the current remote directory. The next call to GetDirCount or another indexed listing method retrieves a fresh listing from the server.

The cache is automatically invalidated when the current remote directory or ListPattern changes. Uploading, deleting, renaming, creating, or removing a remote item does not automatically refresh the cache. Changing AllowMlsd, PreferNlst, ListOption, or DirListingCharset also leaves the existing cache intact.

Clears the in-memory FTP protocol log collected while KeepSessionLog is enabled.

Connects to the server specified by Hostname and Port, negotiates any configured proxy and TLS layer, receives the FTP greeting, and authenticates using Username, Password, and Account.

For implicit or explicit FTPS, TLS is established before USER and PASS are sent. Chilkat sends PBSZ 0 and the PROT command required by DataProtection. If the server requires login before accepting those protection commands, Chilkat authenticates and retries them. Rejection of a required protection command causes the connection attempt to fail.

After login, Chilkat sets binary transfer mode with TYPE I, requests SYST, sends FEAT when AutoFeat is enabled, and may send OPTS UTF8 ON when UTF-8 support is advertised and AutoOptsUtf8 is enabled. It also obtains the initial current remote directory.

Calling this method while already connected establishes a new FTP session and replaces the previous session state. The current remote directory, capability state, and listing cache are initialized for the new login.

A failed connection attempt does not leave an underlying plain FTP connection open. To separate connection establishment from authentication, call ConnectOnly followed by LoginAfterConnectOnly.

Returns True for success, False for failure.

Creates an asynchronous task to call the Connect method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Establishes the configured proxy and TCP connection, performs any configured implicit or explicit TLS setup, and receives the FTP server greeting, but does not send USER or PASS. Complete authentication by calling LoginAfterConnectOnly.

With implicit FTPS, the TLS handshake occurs immediately after the TCP connection is established and before the greeting is received. With explicit FTPS, Chilkat first receives the greeting, sends AUTH TLS or AUTH SSL, and then performs the TLS handshake. When the control channel is protected, Chilkat also sends PBSZ 0 and the PROT command required by DataProtection, even though login has not yet occurred.

After success, ConnectVerified is True and LoginVerified remains False. The current remote directory may be unavailable until login because many servers reject PWD before authentication.

Returns True for success, False for failure.

Creates an asynchronous task to call the ConnectOnly method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Upgrades an already-connected clear FTP control channel to explicit TLS. This method is intended for a manually staged connection created with ConnectOnly while Ssl, AuthTls, and AuthSsl were disabled.

Chilkat sends AUTH TLS, performs the TLS handshake, sends PBSZ 0, and then sends the PROT command required by DataProtection. The method does not authenticate; call LoginAfterConnectOnly afterward.

Do not call it when explicit or implicit FTPS was already enabled before connecting.

Returns True for success, False for failure.

Creates an asynchronous task to call the ConvertToTls method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Creates and returns a textual upload plan for the local directory at localDir. The object must be connected because the plan records the current absolute remote directory together with the local source paths.

The generated plan contains absolute local paths and absolute remote directory operations. Treat the text as a Chilkat-generated plan for PutPlan rather than as a portable or stable interchange format.

The plan records what to do, not a snapshot of file contents. If a local file changes before PutPlan executes, the current file contents are uploaded.

Returns True for success, False for failure.

See the notes about PWideChar memory ownership and validity.

Creates an asynchronous task to call the CreatePlan method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Creates the remote directory at remoteDirPath by sending one MKD command. The path is interpreted relative to the current remote directory unless the server recognizes it as absolute.

Chilkat does not split a multi-level path and does not issue separate commands to create missing parent directories. Some servers create all levels from one MKD a/b/c command, while others require the parent directories to exist.

If the directory already exists, the server commonly returns an error. A successful call does not refresh the cached indexed listing; call ClearDirCache when a fresh listing is required.

Returns True for success, False for failure.

Creates an asynchronous task to call the CreateRemoteDir method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Deletes files in the current remote directory whose names match the wildcard pattern in remotePattern. The method returns the number deleted, or -1 if the operation fails.

Chilkat sends a server-side legacy listing request such as LIST *.txt, parses the returned entries, and sends DELE for matching files. Matching case sensitivity and wildcard behavior therefore depend on the server. Matching directories are not removed by this method.

Creates an asynchronous task to call the DeleteMatching method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Deletes the remote file at remoteFilePath. The path may be relative to the current remote directory or absolute according to the server's path syntax.

A successful deletion does not refresh the cached indexed listing. Call ClearDirCache when a fresh listing is required.

Returns True for success, False for failure.

Creates an asynchronous task to call the DeleteRemoteFile method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Recursively deletes the files and subdirectories beneath the current remote directory. Child directories are removed after their contents are deleted, but the current root directory itself remains in place and remains the current remote directory.

Returns True for success, False for failure.

Creates an asynchronous task to call the DeleteTree method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Returns an XML representation of the complete remote directory tree rooted at the current remote directory. The result uses a <dirTree> root, nested <dir name="..."> elements, and file elements containing the name, size, and available modification time.

<dirTree>
  <file sz="123" dt="Mon, 27 Jul 2026 06:55:00 -0500">root.txt</file>
  <dir name="subdir">
    <file sz="456" dt="...">nested.txt</file>
  </dir>
</dirTree>

Chilkat traverses by listing each directory and temporarily changing the server's current directory. Empty directories are included, and the original current remote directory is restored after successful traversal.

Traversal is affected by SyncMustMatch, SyncMustNotMatch, SyncMustMatchDir, and SyncMustNotMatchDir. This method retrieves metadata; it does not download file content.

Returns True for success, False for failure.

See the notes about PWideChar memory ownership and validity.

Creates an asynchronous task to call the DirTreeXml method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Ends the FTP session and closes the control connection. When connected, Chilkat sends QUIT when possible and then closes the socket.

The method is idempotent. Calling it before a connection exists or calling it again after the session is already closed succeeds without sending another FTP command. Historical properties such as ConnectVerified, LoginVerified, Greeting, and LastReply may retain information from the completed session; use CheckConnection for current connection state.

Returns True for success, False for failure.

Creates an asynchronous task to call the Disconnect method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Downloads all selected files and subdirectories beneath the current remote directory and recreates the tree under the local directory at localRoot. Existing local files are overwritten, and eligible empty remote directories are created locally.

The file and directory filters in SyncMustMatch, SyncMustNotMatch, SyncMustMatchDir, and SyncMustNotMatchDir apply. Use SetOldestDateStr to exclude files older than a chosen date.

Returns True for success, False for failure.

Creates an asynchronous task to call the DownloadTree method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Sends FEAT and returns the server's multiline capability reply. A server may return an error when the command is unsupported or not permitted in the current session state.

A successful explicit call performs the same capability processing as automatic FEAT. It can update HasModeZ, listing-extension detection, UTF-8 handling through AutoOptsUtf8, and UseEpsv through AutoSetUseEpsv, even when AutoFeat is False.

Some servers permit FEAT before authentication and others do not.

Returns True for success, False for failure.

See the notes about PWideChar memory ownership and validity.

Creates an asynchronous task to call the Feat method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Returns the creation time for the file or directory named by filename in the current remote directory as an RFC 822 date-time string, such as Fri, 21 Nov 1997 09:55:06 -0600.

filename must be a name, not a path. Set the current remote directory first, and ensure ListPattern matches the name so the item is present in the cached listing.

Returns True for success, False for failure.

See the notes about PWideChar memory ownership and validity.

Creates an asynchronous task to call the GetCreateTimeByNameStr method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Returns the creation time for cached directory-listing entry index as an RFC 822 date-time string, such as Fri, 21 Nov 1997 09:55:06 -0600. index is a zero-based index from 0 through one less than GetDirCount. Creation-time availability depends on the server and listing format.

An invalid index or unavailable creation time is a method failure and sets LastMethodSuccess to False.

Returns True for success, False for failure.

See the notes about PWideChar memory ownership and validity.

Creates an asynchronous task to call the GetCreateTimeStr method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Returns the current working directory reported by the FTP server, normally by using the PWD command.

Returns True for success, False for failure.

See the notes about PWideChar memory ownership and validity.

Creates an asynchronous task to call the GetCurrentRemoteDir method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Returns the number of files and directories in the cached listing of the current remote directory after applying the case-insensitive ListPattern. On the first call, Chilkat obtains and caches the full directory listing and then applies the pattern locally. Repeated indexed listing calls use the cache until it is invalidated. Returns -1 if the listing cannot be obtained or parsed.

The cache is not automatically refreshed by uploads, deletions, renames, directory creation/removal, raw commands, or changes to the listing-command selection properties. Call ClearDirCache when the server contents or desired listing format may have changed.

Creates an asynchronous task to call the GetDirCount method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Downloads the remote file at remoteFilePath to the local filesystem path at localFilePath. The local parent directory must already exist; this method does not create missing local directories.

When not resuming, the downloaded file replaces an existing destination after the server accepts the transfer. If the server rejects the request before transfer begins, such as when the remote file does not exist, an existing destination file is preserved.

Use RestartNext immediately before this call to resume from the existing local file length. ReadTimeout controls data-channel inactivity. If a transfer fails after receiving some data, inspect PartialTransfer; completed bytes are not rolled back.

Returns True for success, False for failure.

Creates an asynchronous task to call the GetFile method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Downloads the remote file at remoteFilePath and appends its bytes to the existing contents of the BinData object in binData. The object is not cleared automatically. No text decoding or line-ending conversion is performed.

When RestartNext is True, the current byte count in binData is used as the resume offset and only the remaining remote bytes are appended.

Returns True for success, False for failure.

Creates an asynchronous task to call the GetFileBd method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Returns the name of cached directory-listing entry index. index is a zero-based index from 0 through one less than GetDirCount. The returned value is the name from the listing, not necessarily a full remote path.

An out-of-range or negative index is a method failure and sets LastMethodSuccess to False.

Returns True for success, False for failure.

See the notes about PWideChar memory ownership and validity.

Creates an asynchronous task to call the GetFilename method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Downloads the remote file at remoteFilePath, decodes its bytes using the charset named by charset, and appends the resulting text to the existing contents of the StringBuilder in sb. The destination is not cleared automatically.

A byte-order mark for the selected encoding is recognized and removed from the decoded text. Invalid byte sequences are replaced during decoding rather than causing the transfer itself to fail.

When RestartNext is True, the existing destination content is used to determine the resume offset, and the remaining decoded content is appended.

Returns True for success, False for failure.

Creates an asynchronous task to call the GetFileSb method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Downloads the remote file at remoteFilePath and writes its bytes to the Stream in toStream.

For a synchronous call, toStream must be configured with a destination sink before the method begins. For an asynchronous call, application code may read from the stream while the background download produces data.

Returns True for success, False for failure.

Creates an asynchronous task to call the GetFileToStream method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Returns the group name or identifier for cached directory-listing entry index. The value is empty when the server does not provide group metadata.

Returns True for success, False for failure.

See the notes about PWideChar memory ownership and validity.

Creates an asynchronous task to call the GetGroup method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Returns True when cached directory-listing entry index is identified as a directory. index is a zero-based index into the current cached listing.

For an invalid index the method returns False and sets LastMethodSuccess to False. Check that property when False must be distinguished from a valid non-directory entry.

Creates an asynchronous task to call the GetIsDirectory method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Returns True when cached directory-listing entry index is identified as a symbolic link. This information is available only when the server's listing format reports it.

For an invalid index the method returns False and sets LastMethodSuccess to False. A valid False result can also mean the entry is not a link or the listing did not provide link metadata.

Creates an asynchronous task to call the GetIsSymbolicLink method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Copies structured supplemental JSON produced by the immediately preceding method into the JsonObject in json. TLS connection and protected data-connection operations can populate information such as the negotiated TLS version.

The data is transient. A later method may replace it or clear it to an empty object, including ordinary commands such as NOOP, raw commands, or Disconnect. Call this method immediately after the operation whose details are needed.

Returns True for success, False for failure.

Returns the last-modified time for the item named by filename in the current remote directory as an RFC 822 date-time string, such as Fri, 21 Nov 1997 09:55:06 -0600.

filename must be a name, not a path. Set the current remote directory first, and ensure ListPattern matches the name.

Returns True for success, False for failure.

See the notes about PWideChar memory ownership and validity.

Creates an asynchronous task to call the GetLastModifiedTimeByNameStr method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Returns the last-modified time for cached directory-listing entry index as an RFC 822 date-time string, such as Fri, 21 Nov 1997 09:55:06 -0600. index is a zero-based index into the current cached listing.

An invalid index or unavailable timestamp is a method failure and sets LastMethodSuccess to False.

Returns True for success, False for failure.

See the notes about PWideChar memory ownership and validity.

Creates an asynchronous task to call the GetLastModifiedTimeStr method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Returns the owner name or identifier for cached directory-listing entry index. The value is empty when a valid entry has no owner metadata. An invalid index is a method failure and sets LastMethodSuccess to False.

Returns True for success, False for failure.

See the notes about PWideChar memory ownership and validity.

Creates an asynchronous task to call the GetOwner method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Returns the permissions or status string for cached directory-listing entry index. The value is empty when the server provides no such metadata. Use GetPermType to determine how to interpret the result.

Returns True for success, False for failure.

See the notes about PWideChar memory ownership and validity.

Creates an asynchronous task to call the GetPermissions method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Returns the format identifier for the permissions string available for cached listing entry index. The value is empty when no permissions are available.

Use GetPermissions to obtain the corresponding value.

Returns True for success, False for failure.

See the notes about PWideChar memory ownership and validity.

Creates an asynchronous task to call the GetPermType method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Downloads the remote file at remoteFilename, decodes the bytes using the character encoding named by charset, and returns the text. A byte-order mark for the selected encoding is recognized and omitted from the returned text.

This method controls file-content decoding. The encoding used for the remote path itself is controlled by CommandCharset.

Returns True for success, False for failure.

See the notes about PWideChar memory ownership and validity.

Creates an asynchronous task to call the GetRemoteFileTextC method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Downloads the remote file at remoteFilename and returns its contents decoded using the ANSI character encoding. Use GetRemoteFileTextC when the file uses UTF-8 or another explicitly known encoding.

Returns True for success, False for failure.

See the notes about PWideChar memory ownership and validity.

Creates an asynchronous task to call the GetRemoteFileTextData method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Loads into the Cert object in cert the leaf certificate presented on the currently connected FTPS control channel.

The method requires an active TLS control connection. A protected data connection does not replace the control-channel certificate returned here, and the certificate is not retained for retrieval after Disconnect.

Returns True for success, False for failure.

Returns the size in bytes of cached directory-listing entry index as a 32-bit integer. Use GetSize64 for large files.

Returns -1 when index is invalid or the size is unavailable. Because this method returns an integer, do not use LastMethodSuccess to interpret the result.

Creates an asynchronous task to call the GetSize method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Returns the size in bytes of cached directory-listing entry index as a 64-bit integer. Returns -1 when index is invalid or the size is unavailable.

Because this method returns an integer, do not use LastMethodSuccess to interpret the result.

Creates an asynchronous task to call the GetSize64 method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Returns the size in bytes of the file named by filename in the current remote directory as a 32-bit integer. Returns -1 when the file is not found or the size cannot be obtained. Use GetSizeByName64 for large files.

filename must be a name, not a path. Set the current remote directory first, and ensure ListPattern matches the name.

Creates an asynchronous task to call the GetSizeByName method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Sends a SIZE command for filename and returns the remote size in bytes as a 64-bit integer. Returns -1 when the server rejects the command, the item is not found, or the size is unavailable.

This method does not depend on the indexed directory cache or ListPattern. Filename and path case sensitivity are determined by the FTP server and its filesystem.

Creates an asynchronous task to call the GetSizeByName64 method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Returns the size in bytes of cached directory-listing entry index as a decimal string. This form avoids integer-size limits in languages without a convenient 64-bit type.

An out-of-range or negative index is a method failure and sets LastMethodSuccess to False.

Returns True for success, False for failure.

See the notes about PWideChar memory ownership and validity.

Creates an asynchronous task to call the GetSizeStr method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Returns the size in bytes of the file named by filename in the current remote directory as a decimal string. This form avoids language-specific integer limits.

filename must be a name, not a path. Set the current remote directory first, and ensure ListPattern matches the name.

Returns True for success, False for failure.

See the notes about PWideChar memory ownership and validity.

Creates an asynchronous task to call the GetSizeStrByName method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Appends to the StringTable in strTable the relative paths affected by the most recent synchronization operation. Existing entries in strTable are preserved.

The appended paths include files uploaded, downloaded, or deleted by SyncDeleteRemote, SyncLocalDir, SyncLocalTree, SyncRemoteTree, or SyncRemoteTree2. When a successful preview has no candidates, no placeholder or empty-string entry is appended.

Sends a legacy LIST request and returns the server's raw textual listing. pattern is appended literally as a server-side listing argument. An empty pattern lists the current remote directory; a value such as *.txt sends a command such as LIST *.txt.

ListOption is also appended literally before pattern. For example, ListOption = "-a" and pattern equal to *.txt send LIST -a *.txt.

This method does not use MLSD, NLST, ListPattern, or the indexed directory cache. Wildcard matching and case sensitivity are determined by the server. The format of LIST output is server-specific.

Returns True for success, False for failure.

See the notes about PWideChar memory ownership and validity.

Creates an asynchronous task to call the GetTextDirListing method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Retrieves a directory listing for pattern and returns parsed entries as an XML document rooted at <remoteDir>. Files are represented by <file> elements containing <name>, <size>, and available time elements; directories are represented by <dir> elements.

<remoteDir>
  <file>
    <name>report.txt</name>
    <size>1234</size>
    <lastModTime full="20260727-065541" ... />
  </file>
  <dir lastModTime="20260727-065542" ...>archive</dir>
</remoteDir>

When pattern is empty, Chilkat uses the normal listing selection: MLSD when allowed and advertised, otherwise LIST or NLST according to the listing properties. When pattern is nonempty, Chilkat sends LIST pattern, so wildcard matching and case sensitivity are server-dependent.

This method does not use or populate the indexed directory cache and ListPattern is not applied.

Returns True for success, False for failure.

See the notes about PWideChar memory ownership and validity.

Creates an asynchronous task to call the GetXmlDirListing method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Uploads the local file at localPath to the remote path at remotePath as a sequence of data transfers, each containing up to chunkSize bytes. The first chunk is sent with STOR, which creates or replaces remotePath, and each later chunk is sent with APPE.

This method addresses a specific FTP failure mode: during one very long data transfer, the control connection is idle and may be silently dropped by a firewall, NAT device, or server timeout. Completing the upload as multiple shorter transfers periodically uses the control channel.

chunkSize is the in-memory chunk size. Larger chunks reduce FTP command overhead but consume more memory and leave the control channel idle longer; smaller chunks have the opposite tradeoff. Transfer counters represent the complete source file, not only the final chunk.

Returns True for success, False for failure.

Creates an asynchronous task to call the LargeFileUpload method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Loads the original caller object associated with the asynchronous Task in task. This is an internal support method for Chilkat's task infrastructure and is not normally needed by application code.

Returns True for success, False for failure.

Authenticates an FTP control connection previously established by ConnectOnly. Chilkat sends USER, PASS, and ACCT when required, then performs the normal post-login initialization such as TYPE I, SYST, capability discovery, and UTF-8 setup.

If authentication is rejected, the same connection cannot be retried by simply changing the credentials and calling this method again. Disconnect or reconnect with ConnectOnly before attempting another login.

Returns True for success, False for failure.

Creates an asynchronous task to call the LoginAfterConnectOnly method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Downloads files in the current remote directory that match remotePattern into the existing local directory at localDir. Subdirectories are not traversed. The method returns the number of files downloaded, or -1 on failure.

localDir must already exist; the method does not create it. Existing local files with matching names are replaced. Chilkat sends a server-side listing request for remotePattern, so wildcard matching and case sensitivity depend on the FTP server and remote filesystem.

Creates an asynchronous task to call the MGetFiles method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Uploads each local file matching pattern to the current remote directory. pattern may include a local directory and wildcard, such as C:/data/*.txt. Subdirectories are not traversed.

Local wildcard behavior follows the local operating system; for example, Windows matching is case-insensitive. Only each matching file's basename is used as the remote filename. Existing remote files are replaced using normal STOR behavior.

The method returns the number of files uploaded, or -1 on failure.

Creates an asynchronous task to call the MPutFiles method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Sends NLST with remoteDirPattern appended literally and returns the names in XML form. An empty remoteDirPattern sends NLST; a value such as *.txt sends NLST *.txt.

<nlst>
  <e>name1</e>
  <e>name2</e>
</nlst>

The response is decoded using DirListingCharset. NLST normally returns names only; the XML does not distinguish files from directories and does not provide reliable sizes, times, ownership, or permissions. Wildcard matching and case sensitivity are server-dependent.

This method does not use or populate the indexed directory cache.

Returns True for success, False for failure.

See the notes about PWideChar memory ownership and validity.

Creates an asynchronous task to call the NlstXml method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Sends the FTP NOOP command. The server must return a positive FTP reply for the method to succeed.

Whether NOOP is accepted before login is server-dependent. This method does not reconnect a closed session.

Returns True for success, False for failure.

Creates an asynchronous task to call the Noop method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Uploads the local filesystem file at localFilePath to the remote path at remoteFilePath.

Uses the FTP STOR command. A normal upload creates a missing remote file or truncates and replaces an existing one. Chilkat does not create missing remote parent directories and does not upload through a temporary remote name followed by an atomic rename.

Use RestartNext immediately before this call to resume an existing partial remote file. IdleTimeoutMs limits how long the upload may remain blocked without forward progress.

Returns True for success, False for failure.

Creates an asynchronous task to call the PutFile method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Uploads the bytes contained in the BinData object in binData to the remote path at remoteFilePath. No character encoding or line-ending conversion is performed.

Uses the FTP STOR command. A normal upload creates a missing remote file or truncates and replaces an existing one. Chilkat does not create missing remote parent directories and does not upload through a temporary remote name followed by an atomic rename.

RestartNext can be used to upload only the bytes beyond the existing remote size.

Returns True for success, False for failure.

Creates an asynchronous task to call the PutFileBd method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Encodes the text in textData using the character encoding named by charset and uploads the resulting bytes to the remote file at remoteFilename.

Uses the FTP STOR command. A normal upload creates a missing remote file or truncates and replaces an existing one. Chilkat does not create missing remote parent directories and does not upload through a temporary remote name followed by an atomic rename.

The content charset is independent of CommandCharset, which controls the encoding of the remote path sent in the FTP command.

Returns True for success, False for failure.

Creates an asynchronous task to call the PutFileFromTextData method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Encodes the text in the StringBuilder sb using the charset named by charset and uploads it to the remote path at remoteFilePath. When includeBom is True, a byte-order mark is included when the selected encoding defines one.

Uses the FTP STOR command. A normal upload creates a missing remote file or truncates and replaces an existing one. Chilkat does not create missing remote parent directories and does not upload through a temporary remote name followed by an atomic rename.

RestartNext can be used for a resumed upload when the existing remote content and encoded byte sequence are compatible.

Returns True for success, False for failure.

Creates an asynchronous task to call the PutFileSb method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Executes the upload plan in plan. alreadyDoneFilename is the local path of a completion log; each successful plan operation is recorded there.

The absolute remote paths stored in the plan are used even if the current remote directory has changed since the plan was created. Local files are opened when this method executes, so changes made after CreatePlan are reflected in the upload.

To resume an interrupted plan, call this method again with the same plan and log path. Operations already recorded as complete are skipped.

Returns True for success, False for failure.

Creates an asynchronous task to call the PutPlan method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Uploads the local directory tree rooted at localDir into the current remote directory, creating remote subdirectories as needed. The contents of localDir become children of the current remote directory.

The file and directory filters in SyncMustMatch, SyncMustNotMatch, SyncMustMatchDir, and SyncMustNotMatchDir apply. Empty eligible local directories are created remotely. Existing remote files are overwritten with STOR.

Returns True for success, False for failure.

Creates an asynchronous task to call the PutTree method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Sends the raw FTP command text in cmd to the server. Use this for a command not otherwise exposed by the API.

cmd contains the command and parameters but must not contain CR or LF characters; such input is rejected without sending anything. Chilkat considers the method successful only when the server returns a positive FTP reply. A 4xx or 5xx reply causes failure and remains available through LastReply.

The method does not parse command-specific semantics. Use SendCommand when the reply text is needed directly.

Returns True for success, False for failure.

Creates an asynchronous task to call the Quote method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Removes the remote directory at remoteDirPath. FTP servers generally require the directory to be empty before it can be removed.

A successful call does not refresh the cached indexed listing. Call ClearDirCache before relying on indexed listing methods.

Returns True for success, False for failure.

Creates an asynchronous task to call the RemoveRemoteDir method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Renames or moves a remote file or directory from existingRemoteFilePath to newRemoteFilePath using the FTP RNFR/RNTO sequence. Include directory components in newRemoteFilePath to move the item within the same FTP server.

Chilkat does not perform a protective destination-existence check. If newRemoteFilePath already exists, one server may reject the rename while another may replace the destination. Cross-directory or cross-filesystem moves are also subject to server policy.

A successful rename does not refresh the cached indexed listing. Call ClearDirCache when a fresh listing is required.

Returns True for success, False for failure.

Creates an asynchronous task to call the RenameRemoteFile method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Sends the raw FTP command in cmd and returns the complete server reply. The command text is sent as UTF-8; CommandCharset is not applied.

cmd must not contain CR or LF characters; such input is rejected without sending anything. A positive FTP reply is returned normally. A 4xx or 5xx reply is treated as method failure and sets LastMethodSuccess to False.

Returns True for success, False for failure.

See the notes about PWideChar memory ownership and validity.

Creates an asynchronous task to call the SendCommand method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Enables MODE Z compression for subsequent data connections. Call this after connecting and only when HasModeZ is True. Uploads, downloads, and directory listings are then transferred through a DEFLATE-compressed stream.

Returns True for success, False for failure.

Creates an asynchronous task to call the SetModeZ method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Sets the oldest remote modification time eligible for DownloadTree. oldestDateTimeStr is an RFC 822 date-time string, such as Fri, 21 Nov 1997 09:55:06 -0600. Files older than the configured value are skipped.

The value remains active for subsequent DownloadTree calls; it is not consumed after one operation. Avoid relying on exact equality at the boundary because legacy LIST timestamps can have reduced precision or ambiguous timezone interpretation.

Enables or disables a named compatibility option. Option-name matching is case-insensitive. Prefix a recognized name with No- to disable it.

The recognized option Microsoft-TLS-1.2-Workaround changes data-channel TLS behavior for compatibility with an old Microsoft FTP server defect. It weakens protocol selection and should be used only for the affected legacy server. An unrecognized option name is rejected.

Returns True for success, False for failure.

Sets the last-modified time of the remote file at remoteFilename. dateTimeStr is an RFC 822 date-time string, such as Fri, 21 Nov 1997 09:55:06 -0600.

Chilkat converts dateTimeStr to UTC and sends a server-supported timestamp-setting extension. Depending on the server, the command may be MFMT YYYYMMDDhhmmss path or the nonstandard timestamp-setting form of MDTM YYYYMMDDhhmmss path. Precision is one second.

FTP has no universally implemented standard for changing a file timestamp; success depends on server extensions and permissions.

Returns True for success, False for failure.

Creates an asynchronous task to call the SetRemoteFileDateTimeStr method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Sets the last-modified time of the remote file at remoteFilename using the CkDateTime in dt.

Chilkat converts the value to UTC and sends a server-supported timestamp-setting extension. Depending on the server, the command may be MFMT YYYYMMDDhhmmss path or the nonstandard timestamp-setting form of MDTM YYYYMMDDhhmmss path. Precision is one second.

FTP has no universally implemented standard for changing a file timestamp; success depends on server extensions and permissions.

Returns True for success, False for failure.

Creates an asynchronous task to call the SetRemoteFileDt method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Copies the password from the SecureString in password for subsequent FTP authentication. This avoids exposing the password as an ordinary immutable language string. It is equivalent to setting Password for login behavior.

Returns True for success, False for failure.

Adds a required match against the FTP server certificate. reqName selects the certificate field and reqValue specifies the required value. Supported field names include SubjectDN, SubjectCN, IssuerDN, IssuerCN, and SAN. Wildcards such as * may be used in reqValue.

Requirement-value matching is case-sensitive. Multiple calls add requirements that are combined with logical AND; every requirement must match.

Requirements are evaluated when the FTPS control-channel TLS connection is established. Adding a new requirement after connection does not retroactively reject the existing control channel and is not applied to later protected data-channel handshakes within that session.

Configures the Cert in cert as the client certificate for FTPS servers that request mutual TLS authentication. The certificate must have access to its private key.

Returns True for success, False for failure.

Configures a client certificate and private key from PEM data or a PEM file. pemDataOrFilename may contain the PEM text or the local filesystem path of a PEM file. pemPassword is the private-key password, or an empty string when the key is not encrypted.

Returns True for success, False for failure.

Loads a client certificate and private key from the local PFX/P12 file at pfxFilename. pfxPassword is the file password. The certificate is used when the FTPS server requests mutual TLS authentication.

Returns True for success, False for failure.

Sets the FTP representation type to ASCII for subsequent transfers. In ASCII mode, the FTP endpoints may translate line endings, and CrlfMode can apply additional conversion on downloads.

Returns True for success, False for failure.

Creates an asynchronous task to call the SetTypeAscii method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Sets the FTP representation type to binary (TYPE I) for subsequent transfers. Binary mode preserves file bytes and is the appropriate default for nearly all modern file types.

Returns True for success, False for failure.

Creates an asynchronous task to call the SetTypeBinary method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Sends a server-specific SITE command. siteCommand contains the text following SITE, for example RECFM=FB LRECL=600.

SITE subcommands are defined by the server, not by the FTP standard, and may require special permissions.

Returns True for success, False for failure.

Creates an asynchronous task to call the Site method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Blocks the calling thread for millisec milliseconds. This is a utility method and performs no FTP network operation.

Sends the FTP STAT command and returns the server's reply. Depending on the server and session state, the reply may contain status information or a directory listing.

Support, accepted arguments, and whether the command is permitted before login are server-dependent.

Returns True for success, False for failure.

See the notes about PWideChar memory ownership and validity.

Creates an asynchronous task to call the Stat method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Recursively compares the remote tree rooted at the current remote directory with the local tree rooted at localRoot and deletes remote files that have no corresponding local file. The synchronization file and directory filters apply. Empty remote directories are not deleted.

Use GetSyncedFiles after the call to obtain the relative paths deleted.

Returns True for success, False for failure.

Creates an asynchronous task to call the SyncDeleteRemote method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Synchronizes files from the current remote directory into the local directory at localRoot without descending into subdirectories. mode selects the same download modes documented for SyncLocalTree.

The filters are case-insensitive and match basenames. In mode 99, only unmatched remote files in the current directory are deleted; nested directories are not traversed and their contents are not examined. Extra local files are not deleted.

Unsupported mode values fail before an FTP command is sent. Use GetSyncedFiles afterward to obtain the affected relative paths.

Returns True for success, False for failure.

Creates an asynchronous task to call the SyncLocalDir method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Synchronizes the remote tree rooted at the current remote directory into the local directory at localRoot. mode selects which files are downloaded or deleted.

The synchronization filters are case-insensitive and match file basenames rather than relative paths. A file is considered newer only when its timestamp is strictly later; equal timestamps do not qualify.

Mode 99 deletes remote files that do not exist locally; it does not delete extra local files. Only the mode values shown in the table are valid. Other values fail before any FTP command is sent. Use GetSyncedFiles afterward to obtain the affected relative paths.

Returns True for success, False for failure.

Creates an asynchronous task to call the SyncLocalTree method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Synchronizes the local tree rooted at localRoot into the current remote directory. mode selects which files are uploaded.

The synchronization filters are case-insensitive and match file basenames rather than relative paths. A file is considered newer only when its timestamp is strictly later; equal timestamps do not qualify.

Only the mode values shown in the table are valid. Other values fail before any FTP command is sent. Use GetSyncedFiles afterward to obtain the relative paths uploaded.

Returns True for success, False for failure.

Creates an asynchronous task to call the SyncRemoteTree method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Provides the upload synchronization behavior and valid modes of SyncRemoteTree with traversal and preview controls. localDirPath is the local root, mode is the upload synchronization mode, bDescend controls whether subdirectories are traversed, and bPreviewOnly selects preview-only mode. File and directory filters apply in both normal and preview operation.

When bPreviewOnly is True, files are not uploaded and the absolute candidate file paths are placed in SyncPreview. Required remote directories may still be created during preview. If no files qualify, the preview is empty.

Unsupported mode values fail before any FTP command is sent and clear SyncPreview. A failed preview also leaves it empty. A subsequent non-preview synchronization clears the previous preview.

Returns True for success, False for failure.

Creates an asynchronous task to call the SyncRemoteTree2 method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Sends SYST and returns the server's operating-system type reply. Chilkat can use this information when interpreting legacy directory listings.

Whether the command is accepted before authentication is server-dependent.

Returns True for success, False for failure.

See the notes about PWideChar memory ownership and validity.

Creates an asynchronous task to call the Syst method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Enables a method call to be aborted by triggering the AbortCheck event at intervals defined by the HeartbeatMs property. If HeartbeatMs is set to its default value of 0, no events will occur. For instance, set HeartbeatMs to 200 to trigger 5 AbortCheck events per second. Return True to abort; return False to continue (not abort)

This provides the percentage completion for any method involving network communications or time-consuming processing, assuming the progress can be measured as a percentage. This event is triggered only when it's possible and logical to express the operation's progress as a percentage. The pctDone argument will range from 1 to 100. For methods that finish quickly, the number of PercentDone callbacks may vary, but the final callback will have pctDone equal to 100. For longer operations, callbacks will not exceed one per percentage point (e.g., 1, 2, 3, ..., 98, 99, 100).

The PercentDone callback also acts as an AbortCheck event. For fast methods where PercentDone fires, an AbortCheck event may not trigger since the PercentDone callback already provides an opportunity to abort. For longer operations, where time between PercentDone callbacks is extended, AbortCheck callbacks enable more responsive operation termination.

Return True to abort; return False to continue (not abort)

This event callback provides tag name/value pairs that detail what occurs during a method call. To discover existing tag names, create code to handle the event, emit the pairs, and review them. Most tag names are self-explanatory.

Note: Some Chilkat methods don't fire any ProgressInfo events.

Called from the background thread when an asynchronous task completes.

Deprecated. Returns the number of bytes received during the current FTP download as a 32-bit unsigned integer. The value is updated while the transfer is running. Use CurBytesReceived instead.

Deprecated. Returns the number of bytes received during the current FTP download as a 64-bit integer. The value is updated while the transfer is running. Use CurBytesReceived64 instead.

Deprecated. Returns the number of bytes received during the current FTP download as a decimal string. The value is updated while the transfer is running. Use CurBytesReceivedStr instead.

See the notes about PWideChar memory ownership and validity.

Deprecated. Returns the number of bytes sent during the current FTP upload as a 32-bit unsigned integer. The value is updated while the transfer is running. Use CurBytesSent instead.

Deprecated. Returns the number of bytes sent during the current FTP upload as a 64-bit integer. The value is updated while the transfer is running. Use CurBytesSent64 instead.

Deprecated. Returns the number of bytes sent during the current FTP upload as a decimal string. The value is updated while the transfer is running. Use CurBytesSentStr instead.

See the notes about PWideChar memory ownership and validity.

Appends the bytes in content to the remote file named by remoteFilename. No character encoding or line-ending conversion is performed.

Returns True for success, False for failure.

Creates an asynchronous task to call the AppendFileFromBinaryData method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Deprecated. Tries the supported traditional FTP-proxy login sequences and returns the first successful ProxyMethod value. Returns 0 when none succeeds and -1 when the test cannot be completed.

Creates an asynchronous task to call the DetermineProxyMethod method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Deprecated. Tests combinations of Ssl, AuthTls, AuthSsl, Port, Passive, and PassiveUseHostAddr by attempting a directory listing, then returns an XML report.

The method performs multiple network attempts and can take significant time. Prefer configuring the connection explicitly from the server's documented FTP/FTPS settings.

Returns True for success, False for failure.

See the notes about PWideChar memory ownership and validity.

Creates an asynchronous task to call the DetermineSettings method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Deprecated. Returns a new DateTime containing the creation time for cached directory-listing entry index. Use GetCreateTimeStr when a string result is preferred. index is a zero-based index from 0 through one less than GetDirCount.

Returns nil on failure

Creates an asynchronous task to call the GetCreateDt method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Deprecated. Returns a new DateTime containing the creation time for the file or directory named by filename in the current remote directory. Use GetCreateTimeByNameStr when a string result is preferred.

filename must be a name, not a path. Set the current remote directory first, and ensure ListPattern matches the name so the item is present in the cached listing.

Returns nil on failure

Creates an asynchronous task to call the GetCreateDtByName method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Deprecated. Returns a new DateTime containing the last-modified time for cached directory-listing entry index. Use GetLastModifiedTimeStr when a string result is preferred.

Returns nil on failure

Creates an asynchronous task to call the GetLastModDt method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Deprecated. Returns a new DateTime containing the last-modified time for the item named by filename in the current remote directory. Use GetLastModifiedTimeByNameStr when a string result is preferred.

filename must be a name, not a path. Set the current remote directory first, and ensure ListPattern matches the name.

Returns nil on failure

Creates an asynchronous task to call the GetLastModDtByName method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Downloads the remote file at remoteFilename and returns its bytes. No character decoding or line-ending conversion is performed.

Returns True for success, False for failure.

Creates an asynchronous task to call the GetRemoteFileBinaryData method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure

Deprecated. Returns a new Cert containing the certificate presented by the FTP server during the current or most recent TLS connection. Use GetServerCert instead.

Returns nil on failure

Creates or replaces the remote file at remoteFilename with the bytes in content. No character encoding or line-ending conversion is performed.

Returns True for success, False for failure.

Creates an asynchronous task to call the PutFileFromBinaryData method with the arguments provided.

Note: Async method event callbacks happen in the background thread. Accessing and updating UI elements existing in the main thread may require special considerations.

Returns nil on failure