StartByte Property

The offset in bytes at which to begin the Upload or Download.


ANSI (Cross Platform)
int64 GetStartByte();
int SetStartByte(int64 lStartByte); Unicode (Windows) LONG64 GetStartByte();
INT SetStartByte(LONG64 lStartByte);
@property (nonatomic,readwrite,assign,getter=startByte,setter=setStartByte:) long long startByte;
- (long long)startByte;
- (void)setStartByte:(long long)newStartByte;

IPWORKSSFTP_EXTERNAL void* IPWORKSSFTP_CALL IPWorksSFTP_SFTP_Get(void *lpObj, int propid, int arridx, int *lpcbVal, int64 *lpllVal);
IPWORKSSFTP_EXTERNAL int IPWORKSSFTP_CALL IPWorksSFTP_SFTP_Set(void *lpObj, int propid, int arridx, const void *val, int cbVal);

Default Value



The StartByte property is used by the Upload and Download methods to determine at what offset to begin the transfer. This allows for resuming both uploads and downloads. The value of this property is reset to 0 after a successful transfer. StartByte is not valid for use with Append.

When downloading, this property can be used in conjunction with the TransferredDataLimit configuration setting in order to only download a specific range of data from the current RemoteFile.

Data Type


Copyright (c) 2022 /n software inc. - All rights reserved.
IPWorks SFTP 2020 C++ Edition - Version 20.0 [Build 8263]