StartByte Property

The byte index in RemoteFile and LocalFile from which to start the transmission.

Syntax

ANSI (Cross Platform)
char* GetStartByte();
int SetStartByte(const char* lpszStartByte); Unicode (Windows) LPWSTR GetStartByte();
INT SetStartByte(LPCWSTR lpszStartByte);
@property (nonatomic,readwrite,assign,getter=startByte,setter=setStartByte:) NSString* startByte;
- (NSString*)startByte;
- (void)setStartByte:(NSString*)newStartByte;
#define PID_FTP_STARTBYTE 40

IPWORKSEDI_EXTERNAL void* IPWORKSEDI_CALL IPWorksEDI_FTP_Get(void *lpObj, int propid, int arridx, int *lpcbVal, int64 *lpllVal);
IPWORKSEDI_EXTERNAL int IPWORKSEDI_CALL IPWorksEDI_FTP_Set(void *lpObj, int propid, int arridx, const void *val, int cbVal);

Default Value

"0"

Remarks

This property contains a zero-based index in both RemoteFile and LocalFile that determines the point where the transmission of data starts from. This is useful for resuming interrupted downloads and uploads of files from FTP servers.

Once set, the StartByte index is used for all future downloads/uploads. The property must be reset to "0" for normal downloads/uploads.

The type of the property is a string instead of numeric to allow for certain implementations that expect an alphanumeric marker of the start index.

In the Transfer event, the TransferredBytes parameter will include the bytes skipped (i.e. it will show StartByte more bytes than actually transferred).

NOTE: some FTP servers may not support the FTP 'REST' command. If that is the case with the server you are accessing, you will not be able to use the StartByte property.

This property is not available at design time.

Data Type

String

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