UploadArchive Method

Uploads an archive to a vault.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
char* UploadArchive(const char* lpszVaultName, const char* lpszArchiveDesc);

Unicode (Windows)
LPWSTR UploadArchive(LPCWSTR lpszVaultName, LPCWSTR lpszArchiveDesc);

- (NSString*)uploadArchive:(NSString*)vaultName :(NSString*)archiveDesc;

#define MID_AMAZONGLACIER_UPLOADARCHIVE 25

IPWORKSCLOUD_EXTERNAL int IPWORKSCLOUD_CALL IPWorksCloud_AmazonGlacier_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);

Remarks

This method uploads an archive to the vault specified by VaultName. If SetUploadStream was used to specify a valid stream, the archive data will be read from there. If LocalFile is set, the archive data will be read from the specified file. If LocalFile is not set, the data set in ArchiveData will be used.

The ArchiveDesc parameter may be set to a user friendly description of the archive. The description must be less than or equal to 1,024 characters. The allowable characters are 7-bit ASCII without control codes, specifically ASCII values 32-126 decimal or 0x20-0x7E hexadecimal.

This method returns the ArchiveId if the data was successfully uploaded.

Error Handling (C++)

This method returns a String value; after it returns, call the GetLastErrorCode() method to obtain its result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message.