AmazonGlacier Class

Properties   Methods   Events   Config Settings   Errors  

The AmazonGlacier class provides a quick way to interface with Amazon's Glacier service.

Syntax

AmazonGlacier

Remarks

The AmazonGlacier class allows you to simply access Amazon's Glacier service. Glacier allows you to create vaults and store archives.

Before using the class you must first have an AWS account and sign up for the Glacier service. To use the class first set AccessKey and SecretKey.

To create a vault call CreateVault. Once the vault is created you are ready to upload archives to store in the vault. Set LocalFile to the file you want to upload and call UploadArchive.

To retrieve an archive you must create a job. Jobs are long running operations and Amazon will notify you when the job is complete. To create a job call CreateJob. Use the SetNotificationInfo method to set notification options at the vault level. You may also supply an Amazon SNS topic to CreateJob to which Amazon will publish notification about the job status.

You can also call CreateJob to create an Inventory Retrieval job to list the contents of a vault.

After the job is complete use GetJobOutput to retrieve the data.

Additionally, multipart uploads are supported through the StartMultipartUpload and CompleteMultipartUpload methods. Various other operations such as DeleteArchive, GetJobInfo, ListJobs, ListMultipartUploads, ListVaults, and more provide additional functionality.

Property List

The following is the full list of the properties of the class with short descriptions. Click on the links for further details.

Method List

The following is the full list of the methods of the class with short descriptions. Click on the links for further details.

Event List

The following is the full list of the events fired by the class with short descriptions. Click on the links for further details.

Config Settings

The following is a list of config settings for the class with short descriptions. Click on the links for further details.

AccessKey Property (AmazonGlacier Class)

The access key to use for authentication.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetAccessKey();
int SetAccessKey(const char* lpszAccessKey);

Unicode (Windows)
LPWSTR GetAccessKey();
INT SetAccessKey(LPCWSTR lpszAccessKey);

char* cloudstorage_amazonglacier_getaccesskey(void* lpObj);
int cloudstorage_amazonglacier_setaccesskey(void* lpObj, const char* lpszAccessKey);

QString GetAccessKey();
int SetAccessKey(QString qsAccessKey);

Default Value

""

Remarks

This property specifies the access key that should be used for authentication. Both this property and SecretKey must be set before attempting any operations which connect to the server.

Data Type

String

ArchiveData Property (AmazonGlacier Class)

Holds the archive data.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetArchiveData(char* &lpArchiveData, int &lenArchiveData);
int SetArchiveData(const char* lpArchiveData, int lenArchiveData);

Unicode (Windows)
INT GetArchiveData(LPSTR &lpArchiveData, INT &lenArchiveData);
INT SetArchiveData(LPCSTR lpArchiveData, INT lenArchiveData);

int cloudstorage_amazonglacier_getarchivedata(void* lpObj, char** lpArchiveData, int* lenArchiveData);
int cloudstorage_amazonglacier_setarchivedata(void* lpObj, const char* lpArchiveData, int lenArchiveData);

QByteArray GetArchiveData();
int SetArchiveData(QByteArray qbaArchiveData);

Default Value

""

Remarks

This property holds the archive data. It is populated after calling GetJobOutput when the job is an archive retrieval. It may be set to archive data before calling UploadArchive.

This property is not available at design time.

Data Type

Binary String

EncryptionAlgorithm Property (AmazonGlacier Class)

The encryption algorithm.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetEncryptionAlgorithm();
int SetEncryptionAlgorithm(int iEncryptionAlgorithm);

Unicode (Windows)
INT GetEncryptionAlgorithm();
INT SetEncryptionAlgorithm(INT iEncryptionAlgorithm);

EA_AES(0), 
EA_BLOWFISH(1), 
EA_CAST(2), 
EA_DES(3), 
EA_IDEA(4), 
EA_RC2(5), 
EA_RC4(6), 
EA_TEA(7), 
EA_TRIPLE_DES(8), 
EA_TWOFISH(9), 
EA_RIJNDAEL(10), 
EA_CHA_CHA(11), 
EA_XSALSA_20(12)

int cloudstorage_amazonglacier_getencryptionalgorithm(void* lpObj);
int cloudstorage_amazonglacier_setencryptionalgorithm(void* lpObj, int iEncryptionAlgorithm);

int GetEncryptionAlgorithm();
int SetEncryptionAlgorithm(int iEncryptionAlgorithm);

Default Value

0

Remarks

This property specifies the encryption algorithm to be used. The maximum allowable key size is automatically used for the selected algorithm. Possible values are:

Data Type

Integer

EncryptionPassword Property (AmazonGlacier Class)

The encryption password.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetEncryptionPassword();
int SetEncryptionPassword(const char* lpszEncryptionPassword);

Unicode (Windows)
LPWSTR GetEncryptionPassword();
INT SetEncryptionPassword(LPCWSTR lpszEncryptionPassword);

char* cloudstorage_amazonglacier_getencryptionpassword(void* lpObj);
int cloudstorage_amazonglacier_setencryptionpassword(void* lpObj, const char* lpszEncryptionPassword);

QString GetEncryptionPassword();
int SetEncryptionPassword(QString qsEncryptionPassword);

Default Value

""

Remarks

If this property is populated when UploadFile or DownloadFile is called, the class will attempt to encrypt or decrypt the data before uploading or after downloading it.

The class uses the value specified here to generate the necessary encryption Key and IV values using the PKCS5 password digest algorithm. This provides a simpler alternative to creating and managing Key and IV values directly.

However, it is also possible to explicitly specify the Key and IV values to use by setting the EncryptionKey and EncryptionIV configuration settings. This may be necessary if, e.g., the data needs to be encrypted/decrypted by another utility which generates Key and IV values differently.

This property is not available at design time.

Data Type

String

Firewall Property (AmazonGlacier Class)

A set of properties related to firewall access.

Syntax

• C++
• C
• Qt

CloudStorageFirewall* GetFirewall();
int SetFirewall(CloudStorageFirewall* val);

int cloudstorage_amazonglacier_getfirewallautodetect(void* lpObj);
int cloudstorage_amazonglacier_setfirewallautodetect(void* lpObj, int bFirewallAutoDetect);

int cloudstorage_amazonglacier_getfirewalltype(void* lpObj);
int cloudstorage_amazonglacier_setfirewalltype(void* lpObj, int iFirewallType);

char* cloudstorage_amazonglacier_getfirewallhost(void* lpObj);
int cloudstorage_amazonglacier_setfirewallhost(void* lpObj, const char* lpszFirewallHost);

char* cloudstorage_amazonglacier_getfirewallpassword(void* lpObj);
int cloudstorage_amazonglacier_setfirewallpassword(void* lpObj, const char* lpszFirewallPassword);

int cloudstorage_amazonglacier_getfirewallport(void* lpObj);
int cloudstorage_amazonglacier_setfirewallport(void* lpObj, int iFirewallPort);

char* cloudstorage_amazonglacier_getfirewalluser(void* lpObj);
int cloudstorage_amazonglacier_setfirewalluser(void* lpObj, const char* lpszFirewallUser);

bool GetFirewallAutoDetect();
int SetFirewallAutoDetect(bool bFirewallAutoDetect);

int GetFirewallType();
int SetFirewallType(int iFirewallType);

QString GetFirewallHost();
int SetFirewallHost(QString qsFirewallHost);

QString GetFirewallPassword();
int SetFirewallPassword(QString qsFirewallPassword);

int GetFirewallPort();
int SetFirewallPort(int iFirewallPort);

QString GetFirewallUser();
int SetFirewallUser(QString qsFirewallUser);

Remarks

This is a Firewall-type property, which contains fields describing the firewall through which the class will attempt to connect.

Data Type

CloudStorageFirewall

Idle Property (AmazonGlacier Class)

The current status of the class.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetIdle();

Unicode (Windows)
BOOL GetIdle();

int cloudstorage_amazonglacier_getidle(void* lpObj);

bool GetIdle();

Default Value

TRUE

Remarks

This property will be False if the component is currently busy (communicating or waiting for an answer), and True at all other times.

This property is read-only.

Data Type

Boolean

InventoryData Property (AmazonGlacier Class)

Holds the inventory data.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetInventoryData(char* &lpInventoryData, int &lenInventoryData);

Unicode (Windows)
INT GetInventoryData(LPSTR &lpInventoryData, INT &lenInventoryData);

int cloudstorage_amazonglacier_getinventorydata(void* lpObj, char** lpInventoryData, int* lenInventoryData);

QByteArray GetInventoryData();

Default Value

""

Remarks

This property holds the inventory data and is populated after calling GetJobOutput if the job is an inventory retrieval job.

This property is read-only and not available at design time.

Data Type

Binary String

JobMarker Property (AmazonGlacier Class)

A marker used to get the next page of results.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetJobMarker();
int SetJobMarker(const char* lpszJobMarker);

Unicode (Windows)
LPWSTR GetJobMarker();
INT SetJobMarker(LPCWSTR lpszJobMarker);

char* cloudstorage_amazonglacier_getjobmarker(void* lpObj);
int cloudstorage_amazonglacier_setjobmarker(void* lpObj, const char* lpszJobMarker);

QString GetJobMarker();
int SetJobMarker(QString qsJobMarker);

Default Value

""

Remarks

This property is populated after calling ListJobs if the results are paged. This property holds the marker that will be sent in the next call to ListJobs to get the next page of results.

This property is not available at design time.

Data Type

String

Jobs Property (AmazonGlacier Class)

A collection providing details about the jobs.

Syntax

• C++
• C
• Qt

CloudStorageList<CloudStorageGlacierJob>* GetJobs();

int cloudstorage_amazonglacier_getjobcount(void* lpObj);

char* cloudstorage_amazonglacier_getjobarchiveid(void* lpObj, int jobindex);

char* cloudstorage_amazonglacier_getjobarchivesha256treehash(void* lpObj, int jobindex);

int64 cloudstorage_amazonglacier_getjobarchivesize(void* lpObj, int jobindex);

int cloudstorage_amazonglacier_getjobcompleted(void* lpObj, int jobindex);

char* cloudstorage_amazonglacier_getjobcompletiondate(void* lpObj, int jobindex);

char* cloudstorage_amazonglacier_getjobcreationdate(void* lpObj, int jobindex);

char* cloudstorage_amazonglacier_getjobdescription(void* lpObj, int jobindex);

int64 cloudstorage_amazonglacier_getjobinventorysize(void* lpObj, int jobindex);

char* cloudstorage_amazonglacier_getjobid(void* lpObj, int jobindex);

char* cloudstorage_amazonglacier_getjobsha256treehash(void* lpObj, int jobindex);

char* cloudstorage_amazonglacier_getjobsnstopic(void* lpObj, int jobindex);

int cloudstorage_amazonglacier_getjobstatuscode(void* lpObj, int jobindex);

char* cloudstorage_amazonglacier_getjobstatusmessage(void* lpObj, int jobindex);

int cloudstorage_amazonglacier_getjobtype(void* lpObj, int jobindex);

char* cloudstorage_amazonglacier_getjobvaultarn(void* lpObj, int jobindex);

int GetJobCount();

QString GetJobArchiveId(int iJobIndex);

QString GetJobArchiveSHA256TreeHash(int iJobIndex);

qint64 GetJobArchiveSize(int iJobIndex);

bool GetJobCompleted(int iJobIndex);

QString GetJobCompletionDate(int iJobIndex);

QString GetJobCreationDate(int iJobIndex);

QString GetJobDescription(int iJobIndex);

qint64 GetJobInventorySize(int iJobIndex);

QString GetJobId(int iJobIndex);

QString GetJobSHA256TreeHash(int iJobIndex);

QString GetJobSNSTopic(int iJobIndex);

int GetJobStatusCode(int iJobIndex);

QString GetJobStatusMessage(int iJobIndex);

int GetJobType(int iJobIndex);

QString GetJobVaultArn(int iJobIndex);

Remarks

This collection is populated after calling GetJobInfo or ListJobs. It holds details about the jobs.

This property is read-only and not available at design time.

Data Type

CloudStorageGlacierJob

LocalFile Property (AmazonGlacier Class)

The path to a local file for uploading or downloading.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetLocalFile();
wchar_t* GetLocalFile_W(); // Windows only
int SetLocalFile(const char* lpszLocalFile);
int SetLocalFile(const wchar_t* lpszLocalFile); // Windows only

Unicode (Windows)
LPWSTR GetLocalFile();
INT SetLocalFile(LPCWSTR lpszLocalFile);

char* cloudstorage_amazonglacier_getlocalfile(void* lpObj);
wchar_t* cloudstorage_amazonglacier_getlocalfile_W(void* lpObj); // Windows only
int cloudstorage_amazonglacier_setlocalfile(void* lpObj, const char* lpszLocalFile);
int cloudstorage_amazonglacier_setlocalfile(void* lpObj, const wchar_t* lpszLocalFile); // Windows only

QString GetLocalFile();
int SetLocalFile(QString qsLocalFile);

Default Value

""

Remarks

This property is used to specify a local file that will be used for uploading or downloading. Set this to a local file before calling GetJobOutput. Set this to a local file to upload before calling UploadArchive.

This property is not available at design time.

Data Type

String

LocalHost Property (AmazonGlacier Class)

The name of the local host or user-assigned IP interface through which connections are initiated or accepted.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetLocalHost();
int SetLocalHost(const char* lpszLocalHost);

Unicode (Windows)
LPWSTR GetLocalHost();
INT SetLocalHost(LPCWSTR lpszLocalHost);

char* cloudstorage_amazonglacier_getlocalhost(void* lpObj);
int cloudstorage_amazonglacier_setlocalhost(void* lpObj, const char* lpszLocalHost);

QString GetLocalHost();
int SetLocalHost(QString qsLocalHost);

Default Value

""

Remarks

This property contains the name of the local host as obtained by the gethostname() system call, or if the user has assigned an IP address, the value of that address.

In multihomed hosts (machines with more than one IP interface) setting LocalHost to the IP address of an interface will make the class initiate connections (or accept in the case of server classs) only through that interface. It is recommended to provide an IP address rather than a hostname when setting this property to ensure the desired interface is used.

If the class is connected, the LocalHost property shows the IP address of the interface through which the connection is made in internet dotted format (aaa.bbb.ccc.ddd). In most cases, this is the address of the local host, except for multihomed hosts (machines with more than one IP interface).

Note: LocalHost is not persistent. You must always set it in code, and never in the property window.

Data Type

String

MultipartUploadMarker Property (AmazonGlacier Class)

A marker used to get the next page of results.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetMultipartUploadMarker();
int SetMultipartUploadMarker(const char* lpszMultipartUploadMarker);

Unicode (Windows)
LPWSTR GetMultipartUploadMarker();
INT SetMultipartUploadMarker(LPCWSTR lpszMultipartUploadMarker);

char* cloudstorage_amazonglacier_getmultipartuploadmarker(void* lpObj);
int cloudstorage_amazonglacier_setmultipartuploadmarker(void* lpObj, const char* lpszMultipartUploadMarker);

QString GetMultipartUploadMarker();
int SetMultipartUploadMarker(QString qsMultipartUploadMarker);

Default Value

""

Remarks

This property is populated after calling ListMultipartUploads if the results are paged. This property holds the marker that will be sent in the next call to ListMultipartUploads to get the next page of results.

This property is not available at design time.

Data Type

String

MultipartUploads Property (AmazonGlacier Class)

A collection of multipart upload details.

Syntax

• C++
• C
• Qt

CloudStorageList<CloudStorageGlacierMultipartUpload>* GetMultipartUploads();

int cloudstorage_amazonglacier_getmultipartuploadcount(void* lpObj);

char* cloudstorage_amazonglacier_getmultipartuploadarchivedescription(void* lpObj, int multipartuploadindex);

char* cloudstorage_amazonglacier_getmultipartuploadcreationdate(void* lpObj, int multipartuploadindex);

int cloudstorage_amazonglacier_getmultipartuploadpartsize(void* lpObj, int multipartuploadindex);

char* cloudstorage_amazonglacier_getmultipartuploadid(void* lpObj, int multipartuploadindex);

char* cloudstorage_amazonglacier_getmultipartuploadvaultarn(void* lpObj, int multipartuploadindex);

int GetMultipartUploadCount();

QString GetMultipartUploadArchiveDescription(int iMultipartUploadIndex);

QString GetMultipartUploadCreationDate(int iMultipartUploadIndex);

int GetMultipartUploadPartSize(int iMultipartUploadIndex);

QString GetMultipartUploadId(int iMultipartUploadIndex);

QString GetMultipartUploadVaultArn(int iMultipartUploadIndex);

Remarks

This collection is populated after calling ListMultipartUploads. It holds information about the current multipart uploads.

This property is read-only and not available at design time.

Data Type

CloudStorageGlacierMultipartUpload

NotificationInfo Property (AmazonGlacier Class)

Holds information about the notification settings for a vault.

Syntax

• C++
• C
• Qt

CloudStorageGlacierNotification* GetNotificationInfo();
int SetNotificationInfo(CloudStorageGlacierNotification* val);

int cloudstorage_amazonglacier_getnotifyeventtype(void* lpObj);
int cloudstorage_amazonglacier_setnotifyeventtype(void* lpObj, int iNotifyEventType);

char* cloudstorage_amazonglacier_getnotifysnstopic(void* lpObj);
int cloudstorage_amazonglacier_setnotifysnstopic(void* lpObj, const char* lpszNotifySNSTopic);

int GetNotifyEventType();
int SetNotifyEventType(int iNotifyEventType);

QString GetNotifySNSTopic();
int SetNotifySNSTopic(QString qsNotifySNSTopic);

Remarks

This property holds notification settings for a vault. It is populated automatically after calling GetNotificationInfo. When calling SetNotificationInfo this specifies the values that will be set.

This property is not available at design time.

Data Type

CloudStorageGlacierNotification

OtherHeaders Property (AmazonGlacier Class)

Other headers as determined by the user (optional).

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetOtherHeaders();
int SetOtherHeaders(const char* lpszOtherHeaders);

Unicode (Windows)
LPWSTR GetOtherHeaders();
INT SetOtherHeaders(LPCWSTR lpszOtherHeaders);

char* cloudstorage_amazonglacier_getotherheaders(void* lpObj);
int cloudstorage_amazonglacier_setotherheaders(void* lpObj, const char* lpszOtherHeaders);

QString GetOtherHeaders();
int SetOtherHeaders(QString qsOtherHeaders);

Default Value

""

Remarks

This property can be set to a string of headers to be appended to the HTTP request headers created from other properties like ContentType and From.

The headers must follow the format Header: Value as described in the HTTP specifications. Header lines should be separated by CRLF ("\r\n") .

Use this property with caution. If this property contains invalid headers, HTTP requests may fail.

This property is useful for extending the functionality of the class beyond what is provided.

This property is not available at design time.

Data Type

String

Overwrite Property (AmazonGlacier Class)

Whether or not the class should overwrite files during transfer.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetOverwrite();
int SetOverwrite(int bOverwrite);

Unicode (Windows)
BOOL GetOverwrite();
INT SetOverwrite(BOOL bOverwrite);

int cloudstorage_amazonglacier_getoverwrite(void* lpObj);
int cloudstorage_amazonglacier_setoverwrite(void* lpObj, int bOverwrite);

bool GetOverwrite();
int SetOverwrite(bool bOverwrite);

Default Value

FALSE

Remarks

This property is a indicates whether or not the class should overwrite downloaded data. If Overwrite is false, the class fails with an error whenever LocalFile exists and GetJobOutput is called.

Data Type

Boolean

ParsedHeaders Property (AmazonGlacier Class)

This property includes a collection of headers returned from the last request.

Syntax

• C++
• C
• Qt

CloudStorageList<CloudStorageHeader>* GetParsedHeaders();

int cloudstorage_amazonglacier_getparsedheadercount(void* lpObj);

char* cloudstorage_amazonglacier_getparsedheaderfield(void* lpObj, int parsedheaderindex);

char* cloudstorage_amazonglacier_getparsedheadervalue(void* lpObj, int parsedheaderindex);

int GetParsedHeaderCount();

QString GetParsedHeaderField(int iParsedHeaderIndex);

QString GetParsedHeaderValue(int iParsedHeaderIndex);

Remarks

This property contains a collection of headers returned from the last request. Whenever headers are returned from the server, the headers are parsed into a collection of headers. Each Header in this collection contains information describing that header.

MaxHeaders can be used to control the maximum number of headers saved.

This property is read-only and not available at design time.

Data Type

CloudStorageHeader

PartMarker Property (AmazonGlacier Class)

A marker used to get the next page of results.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetPartMarker();
int SetPartMarker(const char* lpszPartMarker);

Unicode (Windows)
LPWSTR GetPartMarker();
INT SetPartMarker(LPCWSTR lpszPartMarker);

char* cloudstorage_amazonglacier_getpartmarker(void* lpObj);
int cloudstorage_amazonglacier_setpartmarker(void* lpObj, const char* lpszPartMarker);

QString GetPartMarker();
int SetPartMarker(QString qsPartMarker);

Default Value

""

Remarks

This property is populated after calling ListParts if the results are paged. This property holds the marker that will be sent in the next call to ListParts to get the next page of results.

This property is not available at design time.

Data Type

String

Parts Property (AmazonGlacier Class)

A collection of multipart upload parts.

Syntax

• C++
• C
• Qt

CloudStorageList<CloudStorageGlacierPart>* GetParts();

int cloudstorage_amazonglacier_getpartcount(void* lpObj);

char* cloudstorage_amazonglacier_getpartarchivedescription(void* lpObj, int partindex);

char* cloudstorage_amazonglacier_getpartcreationdate(void* lpObj, int partindex);

char* cloudstorage_amazonglacier_getpartsha256treehash(void* lpObj, int partindex);

int64 cloudstorage_amazonglacier_getpartsize(void* lpObj, int partindex);

int64 cloudstorage_amazonglacier_getpartstartposition(void* lpObj, int partindex);

char* cloudstorage_amazonglacier_getpartuploadid(void* lpObj, int partindex);

char* cloudstorage_amazonglacier_getpartvaultarn(void* lpObj, int partindex);

int GetPartCount();

QString GetPartArchiveDescription(int iPartIndex);

QString GetPartCreationDate(int iPartIndex);

QString GetPartSHA256TreeHash(int iPartIndex);

qint64 GetPartSize(int iPartIndex);

qint64 GetPartStartPosition(int iPartIndex);

QString GetPartUploadId(int iPartIndex);

QString GetPartVaultArn(int iPartIndex);

Remarks

This collection holds details about each of the parts in a multipart upload. It is populated after a call to ListParts.

This property is read-only and not available at design time.

Data Type

CloudStorageGlacierPart

Proxy Property (AmazonGlacier Class)

A set of properties related to proxy access.

Syntax

• C++
• C
• Qt

CloudStorageProxy* GetProxy();
int SetProxy(CloudStorageProxy* val);

int cloudstorage_amazonglacier_getproxyauthscheme(void* lpObj);
int cloudstorage_amazonglacier_setproxyauthscheme(void* lpObj, int iProxyAuthScheme);

int cloudstorage_amazonglacier_getproxyautodetect(void* lpObj);
int cloudstorage_amazonglacier_setproxyautodetect(void* lpObj, int bProxyAutoDetect);

char* cloudstorage_amazonglacier_getproxypassword(void* lpObj);
int cloudstorage_amazonglacier_setproxypassword(void* lpObj, const char* lpszProxyPassword);

int cloudstorage_amazonglacier_getproxyport(void* lpObj);
int cloudstorage_amazonglacier_setproxyport(void* lpObj, int iProxyPort);

char* cloudstorage_amazonglacier_getproxyserver(void* lpObj);
int cloudstorage_amazonglacier_setproxyserver(void* lpObj, const char* lpszProxyServer);

int cloudstorage_amazonglacier_getproxyssl(void* lpObj);
int cloudstorage_amazonglacier_setproxyssl(void* lpObj, int iProxySSL);

char* cloudstorage_amazonglacier_getproxyuser(void* lpObj);
int cloudstorage_amazonglacier_setproxyuser(void* lpObj, const char* lpszProxyUser);

int GetProxyAuthScheme();
int SetProxyAuthScheme(int iProxyAuthScheme);

bool GetProxyAutoDetect();
int SetProxyAutoDetect(bool bProxyAutoDetect);

QString GetProxyPassword();
int SetProxyPassword(QString qsProxyPassword);

int GetProxyPort();
int SetProxyPort(int iProxyPort);

QString GetProxyServer();
int SetProxyServer(QString qsProxyServer);

int GetProxySSL();
int SetProxySSL(int iProxySSL);

QString GetProxyUser();
int SetProxyUser(QString qsProxyUser);

Remarks

This property contains fields describing the proxy through which the class will attempt to connect.

Data Type

CloudStorageProxy

Region Property (AmazonGlacier Class)

The region the class will make requests against.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetRegion();
int SetRegion(const char* lpszRegion);

Unicode (Windows)
LPWSTR GetRegion();
INT SetRegion(LPCWSTR lpszRegion);

char* cloudstorage_amazonglacier_getregion(void* lpObj);
int cloudstorage_amazonglacier_setregion(void* lpObj, const char* lpszRegion);

QString GetRegion();
int SetRegion(QString qsRegion);

Default Value

"us-east-1"

Remarks

This property controls which region the class will make requests against. By default the class uses us-east-1, the US East (N. Virginia) region. This property should be changed to create or access resources in other regions.

Regions:

The class will always convert this property's value to lowercase. If this property is cleared, the class will reset it to the default value.

Data Type

String

SecretKey Property (AmazonGlacier Class)

The secret key to use for authentication.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetSecretKey();
int SetSecretKey(const char* lpszSecretKey);

Unicode (Windows)
LPWSTR GetSecretKey();
INT SetSecretKey(LPCWSTR lpszSecretKey);

char* cloudstorage_amazonglacier_getsecretkey(void* lpObj);
int cloudstorage_amazonglacier_setsecretkey(void* lpObj, const char* lpszSecretKey);

QString GetSecretKey();
int SetSecretKey(QString qsSecretKey);

Default Value

""

Remarks

This property specifies the secret key that should be used for authentication. Both this property and AccessKey must be set before attempting any operations which connect to the server.

Data Type

String

SSLAcceptServerCert Property (AmazonGlacier Class)

Instructs the class to unconditionally accept the server certificate that matches the supplied certificate.

Syntax

• C++
• C
• Qt

CloudStorageCertificate* GetSSLAcceptServerCert();
int SetSSLAcceptServerCert(CloudStorageCertificate* val);

char* cloudstorage_amazonglacier_getsslacceptservercerteffectivedate(void* lpObj);

char* cloudstorage_amazonglacier_getsslacceptservercertexpirationdate(void* lpObj);

char* cloudstorage_amazonglacier_getsslacceptservercertextendedkeyusage(void* lpObj);

char* cloudstorage_amazonglacier_getsslacceptservercertfingerprint(void* lpObj);

char* cloudstorage_amazonglacier_getsslacceptservercertfingerprintsha1(void* lpObj);

char* cloudstorage_amazonglacier_getsslacceptservercertfingerprintsha256(void* lpObj);

char* cloudstorage_amazonglacier_getsslacceptservercertissuer(void* lpObj);

char* cloudstorage_amazonglacier_getsslacceptservercertprivatekey(void* lpObj);

int cloudstorage_amazonglacier_getsslacceptservercertprivatekeyavailable(void* lpObj);

char* cloudstorage_amazonglacier_getsslacceptservercertprivatekeycontainer(void* lpObj);

char* cloudstorage_amazonglacier_getsslacceptservercertpublickey(void* lpObj);

char* cloudstorage_amazonglacier_getsslacceptservercertpublickeyalgorithm(void* lpObj);

int cloudstorage_amazonglacier_getsslacceptservercertpublickeylength(void* lpObj);

char* cloudstorage_amazonglacier_getsslacceptservercertserialnumber(void* lpObj);

char* cloudstorage_amazonglacier_getsslacceptservercertsignaturealgorithm(void* lpObj);

int cloudstorage_amazonglacier_getsslacceptservercertstore(void* lpObj, char** lpSSLAcceptServerCertStore, int* lenSSLAcceptServerCertStore);
int cloudstorage_amazonglacier_setsslacceptservercertstore(void* lpObj, const char* lpSSLAcceptServerCertStore, int lenSSLAcceptServerCertStore);

char* cloudstorage_amazonglacier_getsslacceptservercertstorepassword(void* lpObj);
int cloudstorage_amazonglacier_setsslacceptservercertstorepassword(void* lpObj, const char* lpszSSLAcceptServerCertStorePassword);

int cloudstorage_amazonglacier_getsslacceptservercertstoretype(void* lpObj);
int cloudstorage_amazonglacier_setsslacceptservercertstoretype(void* lpObj, int iSSLAcceptServerCertStoreType);

char* cloudstorage_amazonglacier_getsslacceptservercertsubjectaltnames(void* lpObj);

char* cloudstorage_amazonglacier_getsslacceptservercertthumbprintmd5(void* lpObj);

char* cloudstorage_amazonglacier_getsslacceptservercertthumbprintsha1(void* lpObj);

char* cloudstorage_amazonglacier_getsslacceptservercertthumbprintsha256(void* lpObj);

char* cloudstorage_amazonglacier_getsslacceptservercertusage(void* lpObj);

int cloudstorage_amazonglacier_getsslacceptservercertusageflags(void* lpObj);

char* cloudstorage_amazonglacier_getsslacceptservercertversion(void* lpObj);

char* cloudstorage_amazonglacier_getsslacceptservercertsubject(void* lpObj);
int cloudstorage_amazonglacier_setsslacceptservercertsubject(void* lpObj, const char* lpszSSLAcceptServerCertSubject);

int cloudstorage_amazonglacier_getsslacceptservercertencoded(void* lpObj, char** lpSSLAcceptServerCertEncoded, int* lenSSLAcceptServerCertEncoded);
int cloudstorage_amazonglacier_setsslacceptservercertencoded(void* lpObj, const char* lpSSLAcceptServerCertEncoded, int lenSSLAcceptServerCertEncoded);

QString GetSSLAcceptServerCertEffectiveDate();

QString GetSSLAcceptServerCertExpirationDate();

QString GetSSLAcceptServerCertExtendedKeyUsage();

QString GetSSLAcceptServerCertFingerprint();

QString GetSSLAcceptServerCertFingerprintSHA1();

QString GetSSLAcceptServerCertFingerprintSHA256();

QString GetSSLAcceptServerCertIssuer();

QString GetSSLAcceptServerCertPrivateKey();

bool GetSSLAcceptServerCertPrivateKeyAvailable();

QString GetSSLAcceptServerCertPrivateKeyContainer();

QString GetSSLAcceptServerCertPublicKey();

QString GetSSLAcceptServerCertPublicKeyAlgorithm();

int GetSSLAcceptServerCertPublicKeyLength();

QString GetSSLAcceptServerCertSerialNumber();

QString GetSSLAcceptServerCertSignatureAlgorithm();

QByteArray GetSSLAcceptServerCertStore();
int SetSSLAcceptServerCertStore(QByteArray qbaSSLAcceptServerCertStore);

QString GetSSLAcceptServerCertStorePassword();
int SetSSLAcceptServerCertStorePassword(QString qsSSLAcceptServerCertStorePassword);

int GetSSLAcceptServerCertStoreType();
int SetSSLAcceptServerCertStoreType(int iSSLAcceptServerCertStoreType);

QString GetSSLAcceptServerCertSubjectAltNames();

QString GetSSLAcceptServerCertThumbprintMD5();

QString GetSSLAcceptServerCertThumbprintSHA1();

QString GetSSLAcceptServerCertThumbprintSHA256();

QString GetSSLAcceptServerCertUsage();

int GetSSLAcceptServerCertUsageFlags();

QString GetSSLAcceptServerCertVersion();

QString GetSSLAcceptServerCertSubject();
int SetSSLAcceptServerCertSubject(QString qsSSLAcceptServerCertSubject);

QByteArray GetSSLAcceptServerCertEncoded();
int SetSSLAcceptServerCertEncoded(QByteArray qbaSSLAcceptServerCertEncoded);

Remarks

If it finds any issues with the certificate presented by the server, the class will normally terminate the connection with an error.

You may override this behavior by supplying a value for SSLAcceptServerCert. If the certificate supplied in SSLAcceptServerCert is the same as the certificate presented by the server, then the server certificate is accepted unconditionally, and the connection will continue normally.

Note: This functionality is provided only for cases in which you otherwise know that you are communicating with the right server. If used improperly, this property may create a security breach. Use it at your own risk.

Data Type

CloudStorageCertificate

SSLCert Property (AmazonGlacier Class)

The certificate to be used during Secure Sockets Layer (SSL) negotiation.

Syntax

• C++
• C
• Qt

CloudStorageCertificate* GetSSLCert();
int SetSSLCert(CloudStorageCertificate* val);

char* cloudstorage_amazonglacier_getsslcerteffectivedate(void* lpObj);

char* cloudstorage_amazonglacier_getsslcertexpirationdate(void* lpObj);

char* cloudstorage_amazonglacier_getsslcertextendedkeyusage(void* lpObj);

char* cloudstorage_amazonglacier_getsslcertfingerprint(void* lpObj);

char* cloudstorage_amazonglacier_getsslcertfingerprintsha1(void* lpObj);

char* cloudstorage_amazonglacier_getsslcertfingerprintsha256(void* lpObj);

char* cloudstorage_amazonglacier_getsslcertissuer(void* lpObj);

char* cloudstorage_amazonglacier_getsslcertprivatekey(void* lpObj);

int cloudstorage_amazonglacier_getsslcertprivatekeyavailable(void* lpObj);

char* cloudstorage_amazonglacier_getsslcertprivatekeycontainer(void* lpObj);

char* cloudstorage_amazonglacier_getsslcertpublickey(void* lpObj);

char* cloudstorage_amazonglacier_getsslcertpublickeyalgorithm(void* lpObj);

int cloudstorage_amazonglacier_getsslcertpublickeylength(void* lpObj);

char* cloudstorage_amazonglacier_getsslcertserialnumber(void* lpObj);

char* cloudstorage_amazonglacier_getsslcertsignaturealgorithm(void* lpObj);

int cloudstorage_amazonglacier_getsslcertstore(void* lpObj, char** lpSSLCertStore, int* lenSSLCertStore);
int cloudstorage_amazonglacier_setsslcertstore(void* lpObj, const char* lpSSLCertStore, int lenSSLCertStore);

char* cloudstorage_amazonglacier_getsslcertstorepassword(void* lpObj);
int cloudstorage_amazonglacier_setsslcertstorepassword(void* lpObj, const char* lpszSSLCertStorePassword);

int cloudstorage_amazonglacier_getsslcertstoretype(void* lpObj);
int cloudstorage_amazonglacier_setsslcertstoretype(void* lpObj, int iSSLCertStoreType);

char* cloudstorage_amazonglacier_getsslcertsubjectaltnames(void* lpObj);

char* cloudstorage_amazonglacier_getsslcertthumbprintmd5(void* lpObj);

char* cloudstorage_amazonglacier_getsslcertthumbprintsha1(void* lpObj);

char* cloudstorage_amazonglacier_getsslcertthumbprintsha256(void* lpObj);

char* cloudstorage_amazonglacier_getsslcertusage(void* lpObj);

int cloudstorage_amazonglacier_getsslcertusageflags(void* lpObj);

char* cloudstorage_amazonglacier_getsslcertversion(void* lpObj);

char* cloudstorage_amazonglacier_getsslcertsubject(void* lpObj);
int cloudstorage_amazonglacier_setsslcertsubject(void* lpObj, const char* lpszSSLCertSubject);

int cloudstorage_amazonglacier_getsslcertencoded(void* lpObj, char** lpSSLCertEncoded, int* lenSSLCertEncoded);
int cloudstorage_amazonglacier_setsslcertencoded(void* lpObj, const char* lpSSLCertEncoded, int lenSSLCertEncoded);

QString GetSSLCertEffectiveDate();

QString GetSSLCertExpirationDate();

QString GetSSLCertExtendedKeyUsage();

QString GetSSLCertFingerprint();

QString GetSSLCertFingerprintSHA1();

QString GetSSLCertFingerprintSHA256();

QString GetSSLCertIssuer();

QString GetSSLCertPrivateKey();

bool GetSSLCertPrivateKeyAvailable();

QString GetSSLCertPrivateKeyContainer();

QString GetSSLCertPublicKey();

QString GetSSLCertPublicKeyAlgorithm();

int GetSSLCertPublicKeyLength();

QString GetSSLCertSerialNumber();

QString GetSSLCertSignatureAlgorithm();

QByteArray GetSSLCertStore();
int SetSSLCertStore(QByteArray qbaSSLCertStore);

QString GetSSLCertStorePassword();
int SetSSLCertStorePassword(QString qsSSLCertStorePassword);

int GetSSLCertStoreType();
int SetSSLCertStoreType(int iSSLCertStoreType);

QString GetSSLCertSubjectAltNames();

QString GetSSLCertThumbprintMD5();

QString GetSSLCertThumbprintSHA1();

QString GetSSLCertThumbprintSHA256();

QString GetSSLCertUsage();

int GetSSLCertUsageFlags();

QString GetSSLCertVersion();

QString GetSSLCertSubject();
int SetSSLCertSubject(QString qsSSLCertSubject);

QByteArray GetSSLCertEncoded();
int SetSSLCertEncoded(QByteArray qbaSSLCertEncoded);

Remarks

This property includes the digital certificate that the class will use during SSL negotiation. Set this property to a valid certificate before starting SSL negotiation. To set a certificate, you may set the Encoded field to the encoded certificate. To select a certificate, use the store and subject fields.

Data Type

CloudStorageCertificate

SSLProvider Property (AmazonGlacier Class)

The Secure Sockets Layer/Transport Layer Security (SSL/TLS) implementation to use.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetSSLProvider();
int SetSSLProvider(int iSSLProvider);

Unicode (Windows)
INT GetSSLProvider();
INT SetSSLProvider(INT iSSLProvider);

SSLP_AUTOMATIC(0), 
SSLP_PLATFORM(1), 
SSLP_INTERNAL(2)

int cloudstorage_amazonglacier_getsslprovider(void* lpObj);
int cloudstorage_amazonglacier_setsslprovider(void* lpObj, int iSSLProvider);

int GetSSLProvider();
int SetSSLProvider(int iSSLProvider);

Default Value

0

Remarks

This property specifies the SSL/TLS implementation to use. In most cases the default value of 0 (Automatic) is recommended and should not be changed. When set to 0 (Automatic), the class will select whether to use the platform implementation or the internal implementation depending on the operating system as well as the TLS version being used.

Possible values are as follows:

In most cases using the default value (Automatic) is recommended. The class will select a provider depending on the current platform.

When Automatic is selected, on Windows, the class will use the platform implementation. On Linux/macOS, the class will use the internal implementation. When TLS 1.3 is enabled via SSLEnabledProtocols, the internal implementation is used on all platforms.

Data Type

Integer

SSLServerCert Property (AmazonGlacier Class)

The server certificate for the last established connection.

Syntax

• C++
• C
• Qt

CloudStorageCertificate* GetSSLServerCert();

char* cloudstorage_amazonglacier_getsslservercerteffectivedate(void* lpObj);

char* cloudstorage_amazonglacier_getsslservercertexpirationdate(void* lpObj);

char* cloudstorage_amazonglacier_getsslservercertextendedkeyusage(void* lpObj);

char* cloudstorage_amazonglacier_getsslservercertfingerprint(void* lpObj);

char* cloudstorage_amazonglacier_getsslservercertfingerprintsha1(void* lpObj);

char* cloudstorage_amazonglacier_getsslservercertfingerprintsha256(void* lpObj);

char* cloudstorage_amazonglacier_getsslservercertissuer(void* lpObj);

char* cloudstorage_amazonglacier_getsslservercertprivatekey(void* lpObj);

int cloudstorage_amazonglacier_getsslservercertprivatekeyavailable(void* lpObj);

char* cloudstorage_amazonglacier_getsslservercertprivatekeycontainer(void* lpObj);

char* cloudstorage_amazonglacier_getsslservercertpublickey(void* lpObj);

char* cloudstorage_amazonglacier_getsslservercertpublickeyalgorithm(void* lpObj);

int cloudstorage_amazonglacier_getsslservercertpublickeylength(void* lpObj);

char* cloudstorage_amazonglacier_getsslservercertserialnumber(void* lpObj);

char* cloudstorage_amazonglacier_getsslservercertsignaturealgorithm(void* lpObj);

int cloudstorage_amazonglacier_getsslservercertstore(void* lpObj, char** lpSSLServerCertStore, int* lenSSLServerCertStore);

char* cloudstorage_amazonglacier_getsslservercertstorepassword(void* lpObj);

int cloudstorage_amazonglacier_getsslservercertstoretype(void* lpObj);

char* cloudstorage_amazonglacier_getsslservercertsubjectaltnames(void* lpObj);

char* cloudstorage_amazonglacier_getsslservercertthumbprintmd5(void* lpObj);

char* cloudstorage_amazonglacier_getsslservercertthumbprintsha1(void* lpObj);

char* cloudstorage_amazonglacier_getsslservercertthumbprintsha256(void* lpObj);

char* cloudstorage_amazonglacier_getsslservercertusage(void* lpObj);

int cloudstorage_amazonglacier_getsslservercertusageflags(void* lpObj);

char* cloudstorage_amazonglacier_getsslservercertversion(void* lpObj);

char* cloudstorage_amazonglacier_getsslservercertsubject(void* lpObj);

int cloudstorage_amazonglacier_getsslservercertencoded(void* lpObj, char** lpSSLServerCertEncoded, int* lenSSLServerCertEncoded);

QString GetSSLServerCertEffectiveDate();

QString GetSSLServerCertExpirationDate();

QString GetSSLServerCertExtendedKeyUsage();

QString GetSSLServerCertFingerprint();

QString GetSSLServerCertFingerprintSHA1();

QString GetSSLServerCertFingerprintSHA256();

QString GetSSLServerCertIssuer();

QString GetSSLServerCertPrivateKey();

bool GetSSLServerCertPrivateKeyAvailable();

QString GetSSLServerCertPrivateKeyContainer();

QString GetSSLServerCertPublicKey();

QString GetSSLServerCertPublicKeyAlgorithm();

int GetSSLServerCertPublicKeyLength();

QString GetSSLServerCertSerialNumber();

QString GetSSLServerCertSignatureAlgorithm();

QByteArray GetSSLServerCertStore();

QString GetSSLServerCertStorePassword();

int GetSSLServerCertStoreType();

QString GetSSLServerCertSubjectAltNames();

QString GetSSLServerCertThumbprintMD5();

QString GetSSLServerCertThumbprintSHA1();

QString GetSSLServerCertThumbprintSHA256();

QString GetSSLServerCertUsage();

int GetSSLServerCertUsageFlags();

QString GetSSLServerCertVersion();

QString GetSSLServerCertSubject();

QByteArray GetSSLServerCertEncoded();

Remarks

This property contains the server certificate for the last established connection.

SSLServerCert is reset every time a new connection is attempted.

This property is read-only.

Data Type

CloudStorageCertificate

Timeout Property (AmazonGlacier Class)

The timeout for the class.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetTimeout();
int SetTimeout(int iTimeout);

Unicode (Windows)
INT GetTimeout();
INT SetTimeout(INT iTimeout);

int cloudstorage_amazonglacier_gettimeout(void* lpObj);
int cloudstorage_amazonglacier_settimeout(void* lpObj, int iTimeout);

int GetTimeout();
int SetTimeout(int iTimeout);

Default Value

60

Remarks

If the Timeout property is set to 0, all operations will run uninterrupted until successful completion or an error condition is encountered.

If Timeout is set to a positive value, the class will wait for the operation to complete before returning control.

The class will use DoEvents to enter an efficient wait loop during any potential waiting period, making sure that all system events are processed immediately as they arrive. This ensures that the host application does not freeze and remains responsive.

If Timeout expires, and the operation is not yet complete, the class fails with an error.

Note: By default, all timeouts are inactivity timeouts, that is, the timeout period is extended by Timeout seconds when any amount of data is successfully sent or received.

The default value for the Timeout property is 60 seconds.

Data Type

Integer

UseSSL Property (AmazonGlacier Class)

Whether to use SSL/TLS when connecting.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetUseSSL();
int SetUseSSL(int bUseSSL);

Unicode (Windows)
BOOL GetUseSSL();
INT SetUseSSL(BOOL bUseSSL);

int cloudstorage_amazonglacier_getusessl(void* lpObj);
int cloudstorage_amazonglacier_setusessl(void* lpObj, int bUseSSL);

bool GetUseSSL();
int SetUseSSL(bool bUseSSL);

Default Value

TRUE

Remarks

This property specifies whether the class should use SSL/TLS when connecting.

This property is not available at design time.

Data Type

Boolean

VaultMarker Property (AmazonGlacier Class)

A marker used to get the next page of results.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* GetVaultMarker();
int SetVaultMarker(const char* lpszVaultMarker);

Unicode (Windows)
LPWSTR GetVaultMarker();
INT SetVaultMarker(LPCWSTR lpszVaultMarker);

char* cloudstorage_amazonglacier_getvaultmarker(void* lpObj);
int cloudstorage_amazonglacier_setvaultmarker(void* lpObj, const char* lpszVaultMarker);

QString GetVaultMarker();
int SetVaultMarker(QString qsVaultMarker);

Default Value

""

Remarks

This property is populated after calling ListVaults if the results are paged. This property holds the marker that will be sent in the next call to ListVaults to get the next page of results.

This property is not available at design time.

Data Type

String

Vaults Property (AmazonGlacier Class)

A collection of vault information.

Syntax

• C++
• C
• Qt

CloudStorageList<CloudStorageGlacierVault>* GetVaults();

int cloudstorage_amazonglacier_getvaultcount(void* lpObj);

int cloudstorage_amazonglacier_getvaultarchivecount(void* lpObj, int vaultindex);

char* cloudstorage_amazonglacier_getvaultarn(void* lpObj, int vaultindex);

char* cloudstorage_amazonglacier_getvaultcreationdate(void* lpObj, int vaultindex);

char* cloudstorage_amazonglacier_getvaultlastinventorydate(void* lpObj, int vaultindex);

char* cloudstorage_amazonglacier_getvaultname(void* lpObj, int vaultindex);

int64 cloudstorage_amazonglacier_getvaultsize(void* lpObj, int vaultindex);

int GetVaultCount();

int GetVaultArchiveCount(int iVaultIndex);

QString GetVaultArn(int iVaultIndex);

QString GetVaultCreationDate(int iVaultIndex);

QString GetVaultLastInventoryDate(int iVaultIndex);

QString GetVaultName(int iVaultIndex);

qint64 GetVaultSize(int iVaultIndex);

Remarks

This collection is populated after calling ListVaults and GetVaultInfo.

This property is read-only and not available at design time.

Data Type

CloudStorageGlacierVault

AbortMultipartUpload Method (AmazonGlacier Class)

Aborts a multipart upload.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int AbortMultipartUpload(const char* lpszVaultName, const char* lpszUploadId);

Unicode (Windows)
INT AbortMultipartUpload(LPCWSTR lpszVaultName, LPCWSTR lpszUploadId);

int cloudstorage_amazonglacier_abortmultipartupload(void* lpObj, const char* lpszVaultName, const char* lpszUploadId);

int AbortMultipartUpload(const QString& qsVaultName, const QString& qsUploadId);

Remarks

This method aborts a multipart upload specified by UploadId. UploadId is returned from the StartMultipartUpload method.

VaultName specifies the vault in which the archive is created.

Only multipart uploads that are not yet completed can be aborted.

Error Handling (C++)

This method returns a 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. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

CompleteMultipartUpload Method (AmazonGlacier Class)

Completes a multipart upload.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* CompleteMultipartUpload(const char* lpszVaultName, const char* lpszUploadId);

Unicode (Windows)
LPWSTR CompleteMultipartUpload(LPCWSTR lpszVaultName, LPCWSTR lpszUploadId);

char* cloudstorage_amazonglacier_completemultipartupload(void* lpObj, const char* lpszVaultName, const char* lpszUploadId);

QString CompleteMultipartUpload(const QString& qsVaultName, const QString& qsUploadId);

Remarks

This method completes the current multipart upload specified by UploadId.

VaultName specifies the vault in which the archive was created.

This method returns the ArchiveId which identifies the newly created archive. If you call this method twice for the same multipart upload within a short period of time, the same ArchiveId will be returned.

If parts of the archive were uploaded using separate instances of the class you must first list all parts of the archive by calling ListParts until PartMarker is empty (all parts are returned). Information about the parts is required when completing the multipart upload.

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.

Config Method (AmazonGlacier Class)

Sets or retrieves a configuration setting.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* Config(const char* lpszConfigurationString);

Unicode (Windows)
LPWSTR Config(LPCWSTR lpszConfigurationString);

char* cloudstorage_amazonglacier_config(void* lpObj, const char* lpszConfigurationString);

QString Config(const QString& qsConfigurationString);

Remarks

Config is a generic method available in every class. It is used to set and retrieve configuration settings for the class.

These settings are similar in functionality to properties, but they are rarely used. In order to avoid "polluting" the property namespace of the class, access to these internal properties is provided through the Config method.

To set a configuration setting named PROPERTY, you must call Config("PROPERTY=VALUE"), where VALUE is the value of the setting expressed as a string. For boolean values, use the strings "True", "False", "0", "1", "Yes", or "No" (case does not matter).

To read (query) the value of a configuration setting, you must call Config("PROPERTY"). The value will be returned as a string.

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.

CreateJob Method (AmazonGlacier Class)

Creates a new job.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
char* CreateJob(const char* lpszVaultName, int iJobType, const char* lpszArchiveId, const char* lpszSNSTopic);

Unicode (Windows)
LPWSTR CreateJob(LPCWSTR lpszVaultName, INT iJobType, LPCWSTR lpszArchiveId, LPCWSTR lpszSNSTopic);

char* cloudstorage_amazonglacier_createjob(void* lpObj, const char* lpszVaultName, int iJobType, const char* lpszArchiveId, const char* lpszSNSTopic);

QString CreateJob(const QString& qsVaultName, int iJobType, const QString& qsArchiveId, const QString& qsSNSTopic);

Remarks

This method creates a new job. There are two types of jobs, archive retrieval and inventory retrieval. After the job is created this method will return the JobId. Amazon will then execute the job (which may take hours) and then notify you when it is complete.

VaultName specifies the name of the vault.

JobType specifies the operation. Possible values are:

ArchiveId specifies the archive to retrieve when JobType is set to 0 (archive retrieval).

SNSTopic specifies the SNS topic to which the notification will be posted when the operation is complete.

The GetJobInfo method may be called with the returned JobId to check the status of the job. Once the job is completed use the GetJobOutput method to retrieve the data.

Note: JobDescription may optionally be set. JobRetrievalByteRange may be set when JobType is 0 (archive retrieval). JobInventoryFormat may be set when JobType is set to 1 (inventory retrieval).

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.

CreateVault Method (AmazonGlacier Class)

Creates a new vault.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int CreateVault(const char* lpszVaultName);

Unicode (Windows)
INT CreateVault(LPCWSTR lpszVaultName);

int cloudstorage_amazonglacier_createvault(void* lpObj, const char* lpszVaultName);

int CreateVault(const QString& qsVaultName);

Remarks

This method creates a new vault with the name specified by the VaultName parameter.

Names can be between 1 and 255 characters long. Allowed characters are a-z, A-Z, 0-9, '_' (underscore), '-' (hyphen), and '.' (period).

The region in which the vault is created is controlled by the Region property.

Error Handling (C++)

This method returns a 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. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

DeleteArchive Method (AmazonGlacier Class)

Deletes an archive.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int DeleteArchive(const char* lpszVaultName, const char* lpszArchiveId);

Unicode (Windows)
INT DeleteArchive(LPCWSTR lpszVaultName, LPCWSTR lpszArchiveId);

int cloudstorage_amazonglacier_deletearchive(void* lpObj, const char* lpszVaultName, const char* lpszArchiveId);

int DeleteArchive(const QString& qsVaultName, const QString& qsArchiveId);

Remarks

This method deletes the archive specified by the ArchiveId parameter.

Error Handling (C++)

This method returns a 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. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

DeleteNotificationInfo Method (AmazonGlacier Class)

Deletes the notification information for the vault.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int DeleteNotificationInfo(const char* lpszVaultName);

Unicode (Windows)
INT DeleteNotificationInfo(LPCWSTR lpszVaultName);

int cloudstorage_amazonglacier_deletenotificationinfo(void* lpObj, const char* lpszVaultName);

int DeleteNotificationInfo(const QString& qsVaultName);

Remarks

This method deletes the notification information associated with the vault specified by VaultName.

Error Handling (C++)

This method returns a 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. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

DeleteVault Method (AmazonGlacier Class)

Deletes the specified vault.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int DeleteVault(const char* lpszVaultName);

Unicode (Windows)
INT DeleteVault(LPCWSTR lpszVaultName);

int cloudstorage_amazonglacier_deletevault(void* lpObj, const char* lpszVaultName);

int DeleteVault(const QString& qsVaultName);

Remarks

This method deletes the vault specified by VaultName. If the vault is not empty Amazon will return an error.

Call GetVaultInfo to get information about the archive including the number of archives it contains.

Error Handling (C++)

This method returns a 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. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

DoEvents Method (AmazonGlacier Class)

This method processes events from the internal message queue.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int DoEvents();

Unicode (Windows)
INT DoEvents();

int cloudstorage_amazonglacier_doevents(void* lpObj);

int DoEvents();

Remarks

When DoEvents is called, the class processes any available events. If no events are available, it waits for a preset period of time, and then returns.

Error Handling (C++)

This method returns a 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. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

GetJobInfo Method (AmazonGlacier Class)

Retrieves information about the specified job.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetJobInfo(const char* lpszVaultName, const char* lpszJobId);

Unicode (Windows)
INT GetJobInfo(LPCWSTR lpszVaultName, LPCWSTR lpszJobId);

int cloudstorage_amazonglacier_getjobinfo(void* lpObj, const char* lpszVaultName, const char* lpszJobId);

int GetJobInfo(const QString& qsVaultName, const QString& qsJobId);

Remarks

This method retrieves information about the job specified by JobId. The Jobs collection will be populated with information about the job.

Error Handling (C++)

This method returns a 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. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

GetJobOutput Method (AmazonGlacier Class)

Retrieves the output from the job.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetJobOutput(const char* lpszVaultName, const char* lpszJobId);

Unicode (Windows)
INT GetJobOutput(LPCWSTR lpszVaultName, LPCWSTR lpszJobId);

int cloudstorage_amazonglacier_getjoboutput(void* lpObj, const char* lpszVaultName, const char* lpszJobId);

int GetJobOutput(const QString& qsVaultName, const QString& qsJobId);

Remarks

This method retrieves the output from a completed job. If SetDownloadStream has been called the data will be written to the stream. If LocalFile is set, the data will be written to the specified file. If LocalFile is not set the data will be written to either InventoryData or ArchiveData depending on the type of job.

Error Handling (C++)

This method returns a 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. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

GetNotificationInfo Method (AmazonGlacier Class)

Retrieves the notification information for the vault.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetNotificationInfo(const char* lpszVaultName);

Unicode (Windows)
INT GetNotificationInfo(LPCWSTR lpszVaultName);

int cloudstorage_amazonglacier_getnotificationinfo(void* lpObj, const char* lpszVaultName);

int GetNotificationInfo(const QString& qsVaultName);

Remarks

This method retrieves the notification information for the vault specified by VaultName. After this method returns, the results will be available in the NotificationInfo property.

If no notification settings exist for the vault the class fails with an error.

Error Handling (C++)

This method returns a 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. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

GetVaultInfo Method (AmazonGlacier Class)

Retrieves vault details.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int GetVaultInfo(const char* lpszVaultName);

Unicode (Windows)
INT GetVaultInfo(LPCWSTR lpszVaultName);

int cloudstorage_amazonglacier_getvaultinfo(void* lpObj, const char* lpszVaultName);

int GetVaultInfo(const QString& qsVaultName);

Remarks

This method gets information about the vault specified by VaultName. The Vaults property will be populated with the results. The following fields are populated:

• ArchiveCount
• Arn
• CreationDate
• LastInventoryDate
• Name
• Size

Error Handling (C++)

This method returns a 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. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

Interrupt Method (AmazonGlacier Class)

This method interrupts the current method.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int Interrupt();

Unicode (Windows)
INT Interrupt();

int cloudstorage_amazonglacier_interrupt(void* lpObj);

int Interrupt();

Remarks

If there is no method in progress, Interrupt simply returns, doing nothing.

Error Handling (C++)

This method returns a 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. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

ListJobs Method (AmazonGlacier Class)

Lists the jobs in a vault.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int ListJobs(const char* lpszVaultName);

Unicode (Windows)
INT ListJobs(LPCWSTR lpszVaultName);

int cloudstorage_amazonglacier_listjobs(void* lpObj, const char* lpszVaultName);

int ListJobs(const QString& qsVaultName);

Remarks

This method lists the jobs in the vault specified by VaultName.

The JobList event will fire once for each Job returned. In addition, the Jobs collection will be populated.

By default up to 1000 jobs will be returned in a single set of results. The maximum number of results can be specified by setting MaxListJobResults. If the number of results exceeds the maximum the results are paged. The IsJobPaged setting will be set to true and JobMarker will be populated.

To get all results simply call ListJobs again until IsJobPaged returns False and JobMarker is empty string. Alternatively, the AccumulatePages configuration setting can be disabled to clear the Jobs properties every time a page of results is returned.

Note: The settings JobCompletionFilter and JobStatusFilter may be set to control what type of jobs are returned.

Error Handling (C++)

This method returns a 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. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

ListMultipartUploads Method (AmazonGlacier Class)

Lists multipart uploads.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int ListMultipartUploads(const char* lpszVaultName);

Unicode (Windows)
INT ListMultipartUploads(LPCWSTR lpszVaultName);

int cloudstorage_amazonglacier_listmultipartuploads(void* lpObj, const char* lpszVaultName);

int ListMultipartUploads(const QString& qsVaultName);

Remarks

This method lists the current multipart uploads for the vault specified by VaultName. The MultipartUploadList event will fire once for each multipart upload returned. In addition, the MultipartUploads collection will be populated.

By default up to 1000 multipart uploads will be returned in a single set of results. The maximum number of results can be specified by setting MaxListMultipartUploadResults. If the number of results exceeds the maximum the results are paged. The IsMultipartUploadPaged setting will be set to true and MultipartUploadMarker will be populated.

To get all results simply call ListMultipartUploads again until IsMultipartUploadPaged returns False and MultipartUploadMarker is empty string. Alternatively, the AccumulatePages configuration setting can be disabled to clear the MultipartUploads properties every time a page of results is returned.

Error Handling (C++)

This method returns a 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. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

ListParts Method (AmazonGlacier Class)

Lists the parts of a multipart upload.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int ListParts(const char* lpszVaultName, const char* lpszUploadId);

Unicode (Windows)
INT ListParts(LPCWSTR lpszVaultName, LPCWSTR lpszUploadId);

int cloudstorage_amazonglacier_listparts(void* lpObj, const char* lpszVaultName, const char* lpszUploadId);

int ListParts(const QString& qsVaultName, const QString& qsUploadId);

Remarks

This method lists the parts of a multipart upload specified by UploadId.

VaultName identifies the vault in which the archive is created.

The PartList event will fire once for each Part returned. In addition, the Parts collection will be populated.

By default up to 1000 parts will be returned in a single set of results. The maximum number of results can be specified by setting MaxListPartResults. If the number of results exceeds the maximum the results are paged. The IsPartPaged setting will be set to true and PartMarker will be populated.

To get all results simply call ListParts again until IsPartPaged returns False and PartMarker is empty string. Alternatively, the AccumulatePages configuration setting can be disabled to clear the Parts properties every time a page of results is returned.

Error Handling (C++)

This method returns a 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. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

ListVaults Method (AmazonGlacier Class)

Lists the vaults.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int ListVaults();

Unicode (Windows)
INT ListVaults();

int cloudstorage_amazonglacier_listvaults(void* lpObj);

int ListVaults();

Remarks

This method lists the vaults for an account.

By default up to 1000 vaults will be returned in a single set of results. This maximum number of results can be specified by setting MaxListVaultResults. If the number of results exceeds the maximum the results are paged. The IsVaultPaged setting will be set to true and VaultMarker will be populated.

To get all results simply call ListVaults again until IsVaultPaged returns False and VaultMarker is empty string. Alternatively, the AccumulatePages configuration setting can be disabled to clear the Vaults properties every time a page of results is returned.

Error Handling (C++)

This method returns a 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. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

Reset Method (AmazonGlacier Class)

Resets the class to its initial state.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int Reset();

Unicode (Windows)
INT Reset();

int cloudstorage_amazonglacier_reset(void* lpObj);

int Reset();

Remarks

This method resets the class to its initial state.

Error Handling (C++)

This method returns a 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. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

SetDownloadStream Method (AmazonGlacier Class)

Sets the stream to which the downloaded data from the server will be written.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int SetDownloadStream(CloudStorageStream* sDownloadStream);

Unicode (Windows)
INT SetDownloadStream(CloudStorageStream* sDownloadStream);

int cloudstorage_amazonglacier_setdownloadstream(void* lpObj, CloudStorageStream* sDownloadStream);

int SetDownloadStream(CloudStorageStream* sDownloadStream);

Remarks

If a download stream is set before calling GetJobOutput the downloaded data will be written to the stream. The stream should be open and normally set to position 0.

Error Handling (C++)

This method returns a 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. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

SetNotificationInfo Method (AmazonGlacier Class)

Sets notification information for a vault.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int SetNotificationInfo(const char* lpszVaultName);

Unicode (Windows)
INT SetNotificationInfo(LPCWSTR lpszVaultName);

int cloudstorage_amazonglacier_setnotificationinfo(void* lpObj, const char* lpszVaultName);

int SetNotificationInfo(const QString& qsVaultName);

Remarks

This method sets the notification settings for the vault specified by VaultName. The SNSTopic field must be set before calling this method. Optionally, the EventType may also be set.

Error Handling (C++)

This method returns a 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. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

SetUploadStream Method (AmazonGlacier Class)

Sets the stream to be uploaded to the server.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int SetUploadStream(CloudStorageStream* sUploadStream);

Unicode (Windows)
INT SetUploadStream(CloudStorageStream* sUploadStream);

int cloudstorage_amazonglacier_setuploadstream(void* lpObj, CloudStorageStream* sUploadStream);

int SetUploadStream(CloudStorageStream* sUploadStream);

Remarks

If an upload stream is set before calling UploadArchive the data will be read from this stream. The stream should be open and normally set to position 0.

Error Handling (C++)

This method returns a 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. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

StartMultipartUpload Method (AmazonGlacier Class)

Starts a multipart upload.

Syntax

• C++
• C
• Qt

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

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

char* cloudstorage_amazonglacier_startmultipartupload(void* lpObj, const char* lpszVaultName, const char* lpszArchiveDesc);

QString StartMultipartUpload(const QString& qsVaultName, const QString& qsArchiveDesc);

Remarks

This method initiates a multipart upload operation. Multipart uploads are beneficial in situations where you wish to upload a large amount of data, or do not know how large the data will be when you begin uploading.

This method returns an UploadId that must be saved. This will be used to perform other operations with this upload.

ArchiveDesc may be set to a user friendly description of the archive, or empty string.

VaultName is the vault in which the archive will be created.

The data must be split into parts with a size (in megabytes) specified by PartSize. The part size must be a megabyte multiplied by a power of 2. For instance 1, 2, 4, and 8 are valid sizes. The minimum part size is 1, the maximum is 4096 (4GB). The default value of PartSize is 1.

Each part must be exactly PartSize megabytes in size except the last part. The last part will be smaller. For instance with a part size of 1, uploading a 10.2 megabyte file will have 11 parts. There will be 10 parts of size 1 MB, and 1 part of size .2 MB.

Parts may be uploaded in parallel by using separate class instances. When uploading a part with UploadPart a part number is specified so the data can be properly re-assembled in order when it reaches the server.

After all parts are uploaded call CompleteMultipartUpload to complete the operation. If parts of the archive were uploaded using separate instances of the class you must first list all parts of the archive by calling ListParts until PartMarker is empty (all parts are returned). Information about the parts is required when completing the multipart upload.

To cancel the operation, call AbortMultipartUpload.

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.

UploadArchive Method (AmazonGlacier Class)

Uploads an archive to a vault.

Syntax

• C++
• C
• Qt

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

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

char* cloudstorage_amazonglacier_uploadarchive(void* lpObj, const char* lpszVaultName, const char* lpszArchiveDesc);

QString UploadArchive(const QString& qsVaultName, const QString& qsArchiveDesc);

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.

UploadPart Method (AmazonGlacier Class)

Uploads a single part in a multipart upload.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
int UploadPart(const char* lpszVaultName, const char* lpszUploadId, int iPartNumber);

Unicode (Windows)
INT UploadPart(LPCWSTR lpszVaultName, LPCWSTR lpszUploadId, INT iPartNumber);

int cloudstorage_amazonglacier_uploadpart(void* lpObj, const char* lpszVaultName, const char* lpszUploadId, int iPartNumber);

int UploadPart(const QString& qsVaultName, const QString& qsUploadId, int iPartNumber);

Remarks

This method uploads a single part of the multipart upload specified by UploadId.

VaultName is the vault in which the archive is created.

PartNumber identifies this specific part. The first part number is 0. Amazon will re-assemble the archive in the order specified by part numbers.

If SetUploadStream was used to specify a valid stream, the part data will be read from there. If LocalFile is set, the part data will be read from the specified file. If LocalFile is not set, the data set in ArchiveData will be used.

Error Handling (C++)

This method returns a 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. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)

EndTransfer Event (AmazonGlacier Class)

This event fires when a document finishes transferring.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
virtual int FireEndTransfer(AmazonGlacierEndTransferEventParams *e);

typedef struct {
  int Direction;
  int reserved;
} AmazonGlacierEndTransferEventParams;


Unicode (Windows)
virtual INT FireEndTransfer(AmazonGlacierEndTransferEventParams *e);

typedef struct {
  INT Direction;
  INT reserved;
} AmazonGlacierEndTransferEventParams;

#define EID_AMAZONGLACIER_ENDTRANSFER 1

virtual INT CLOUDSTORAGE_CALL FireEndTransfer(INT &iDirection);

class AmazonGlacierEndTransferEventParams {
public:
  int Direction();

  int EventRetVal();
  void SetEventRetVal(int iRetVal);
};

// To handle, connect one or more slots to this signal.
void EndTransfer(AmazonGlacierEndTransferEventParams *e);

// Or, subclass AmazonGlacier and override this emitter function.
virtual int FireEndTransfer(AmazonGlacierEndTransferEventParams *e) {...}

Remarks

The EndTransfer event is fired when the document text finishes transferring from the server to the local host.

The Direction parameter shows whether the client (0) or the server (1) is sending the data.

Error Event (AmazonGlacier Class)

Fired when information is available about errors during data delivery.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
virtual int FireError(AmazonGlacierErrorEventParams *e);

typedef struct {
  int ErrorCode;
  const char *Description;
  int reserved;
} AmazonGlacierErrorEventParams;


Unicode (Windows)
virtual INT FireError(AmazonGlacierErrorEventParams *e);

typedef struct {
  INT ErrorCode;
  LPCWSTR Description;
  INT reserved;
} AmazonGlacierErrorEventParams;

#define EID_AMAZONGLACIER_ERROR 2

virtual INT CLOUDSTORAGE_CALL FireError(INT &iErrorCode, LPSTR &lpszDescription);

class AmazonGlacierErrorEventParams {
public:
  int ErrorCode();

  const QString &Description();

  int EventRetVal();
  void SetEventRetVal(int iRetVal);
};

// To handle, connect one or more slots to this signal.
void Error(AmazonGlacierErrorEventParams *e);

// Or, subclass AmazonGlacier and override this emitter function.
virtual int FireError(AmazonGlacierErrorEventParams *e) {...}

Remarks

The Error event is fired in case of exceptional conditions during message processing. Normally the class fails with an error.

The ErrorCode parameter contains an error code, and the Description parameter contains a textual description of the error. For a list of valid error codes and their descriptions, please refer to the Error Codes section.

Header Event (AmazonGlacier Class)

Fired every time a header line comes in.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
virtual int FireHeader(AmazonGlacierHeaderEventParams *e);

typedef struct {
  const char *Field;
  const char *Value;
  int reserved;
} AmazonGlacierHeaderEventParams;


Unicode (Windows)
virtual INT FireHeader(AmazonGlacierHeaderEventParams *e);

typedef struct {
  LPCWSTR Field;
  LPCWSTR Value;
  INT reserved;
} AmazonGlacierHeaderEventParams;

#define EID_AMAZONGLACIER_HEADER 3

virtual INT CLOUDSTORAGE_CALL FireHeader(LPSTR &lpszField, LPSTR &lpszValue);

class AmazonGlacierHeaderEventParams {
public:
  const QString &Field();

  const QString &Value();

  int EventRetVal();
  void SetEventRetVal(int iRetVal);
};

// To handle, connect one or more slots to this signal.
void Header(AmazonGlacierHeaderEventParams *e);

// Or, subclass AmazonGlacier and override this emitter function.
virtual int FireHeader(AmazonGlacierHeaderEventParams *e) {...}

Remarks

The Field parameter contains the name of the HTTP header (which is the same as it is delivered). The Value parameter contains the header contents.

If the header line being retrieved is a continuation header line, then the Field parameter contains "" (empty string).

JobList Event (AmazonGlacier Class)

Fires once for each job returned when calling ListJobs or GetJobInfo.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
virtual int FireJobList(AmazonGlacierJobListEventParams *e);

typedef struct {
  int JobType;
  const char *ArchiveId;
  int64 ArchiveSize;
  const char *ArchiveSHA256TreeHash;
  int Completed;
  const char *CompletionDate;
  const char *CreationDate;
  const char *Description;
  const char *JobId;
  const char *SNSTopic;
  const char *SHA256TreeHash;
  int StatusCode;
  const char *StatusMessage;
  const char *VaultArn;
  int64 InventorySize;
  int reserved;
} AmazonGlacierJobListEventParams;


Unicode (Windows)
virtual INT FireJobList(AmazonGlacierJobListEventParams *e);

typedef struct {
  INT JobType;
  LPCWSTR ArchiveId;
  LONG64 ArchiveSize;
  LPCWSTR ArchiveSHA256TreeHash;
  BOOL Completed;
  LPCWSTR CompletionDate;
  LPCWSTR CreationDate;
  LPCWSTR Description;
  LPCWSTR JobId;
  LPCWSTR SNSTopic;
  LPCWSTR SHA256TreeHash;
  INT StatusCode;
  LPCWSTR StatusMessage;
  LPCWSTR VaultArn;
  LONG64 InventorySize;
  INT reserved;
} AmazonGlacierJobListEventParams;

#define EID_AMAZONGLACIER_JOBLIST 4

virtual INT CLOUDSTORAGE_CALL FireJobList(INT &iJobType, LPSTR &lpszArchiveId, LONG64 &lArchiveSize, LPSTR &lpszArchiveSHA256TreeHash, BOOL &bCompleted, LPSTR &lpszCompletionDate, LPSTR &lpszCreationDate, LPSTR &lpszDescription, LPSTR &lpszJobId, LPSTR &lpszSNSTopic, LPSTR &lpszSHA256TreeHash, INT &iStatusCode, LPSTR &lpszStatusMessage, LPSTR &lpszVaultArn, LONG64 &lInventorySize);

class AmazonGlacierJobListEventParams {
public:
  int JobType();

  const QString &ArchiveId();

  qint64 ArchiveSize();

  const QString &ArchiveSHA256TreeHash();

  bool Completed();

  const QString &CompletionDate();

  const QString &CreationDate();

  const QString &Description();

  const QString &JobId();

  const QString &SNSTopic();

  const QString &SHA256TreeHash();

  int StatusCode();

  const QString &StatusMessage();

  const QString &VaultArn();

  qint64 InventorySize();

  int EventRetVal();
  void SetEventRetVal(int iRetVal);
};

// To handle, connect one or more slots to this signal.
void JobList(AmazonGlacierJobListEventParams *e);

// Or, subclass AmazonGlacier and override this emitter function.
virtual int FireJobList(AmazonGlacierJobListEventParams *e) {...}

Remarks

This event fires once for each job returned when calling ListJobs. When calling GetJobInfo this event will fire once since only one job is returned.

JobType indicates the type of job. Possible values are:

ArchiveId is the Id of the archive associated with the job.

ArchiveSize is the size in bytes of the archive.

ArchiveSHA256TreeHash is the SHA256 tree hash of the entire archive for an archive retrieval job.

Completed indicates the status of the job.

CompletionDate is the UTC time that the job completed.

CreationDate is the UTC time that the job was created. This is a string representation of ISO 8601 date format, for example: "2012-03-20T17:03:43.221Z".

Description is the user supplied description. This is specified by the JobDescription setting before calling CreateJob.

JobId is the Amazon assigned Id for the job.

SNSTopic is the Amazon SNS topic that will receive notification about the job status.

SHA256TreeHash is the SHA256 tree hash value for the requested range of an archive. This is only applicable when JobType is 0 (archive retrieval) and a JobRetrievalByteRange is set to a tree-hash aligned range.

StatusCode is the current status of the job. Possible values are:

StatusMessage is a user friendly description of the status.

VaultArn is the Amazon Resource Name (ARN) of the vault from which the archive retrieval or inventory retrieval was requested.

InventorySize is the size in bytes of the inventory data.

Log Event (AmazonGlacier Class)

Fired once for each log message.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
virtual int FireLog(AmazonGlacierLogEventParams *e);

typedef struct {
  int LogLevel;
  const char *Message;
  const char *LogType;
  int reserved;
} AmazonGlacierLogEventParams;


Unicode (Windows)
virtual INT FireLog(AmazonGlacierLogEventParams *e);

typedef struct {
  INT LogLevel;
  LPCWSTR Message;
  LPCWSTR LogType;
  INT reserved;
} AmazonGlacierLogEventParams;

#define EID_AMAZONGLACIER_LOG 5

virtual INT CLOUDSTORAGE_CALL FireLog(INT &iLogLevel, LPSTR &lpszMessage, LPSTR &lpszLogType);

class AmazonGlacierLogEventParams {
public:
  int LogLevel();

  const QString &Message();

  const QString &LogType();

  int EventRetVal();
  void SetEventRetVal(int iRetVal);
};

// To handle, connect one or more slots to this signal.
void Log(AmazonGlacierLogEventParams *e);

// Or, subclass AmazonGlacier and override this emitter function.
virtual int FireLog(AmazonGlacierLogEventParams *e) {...}

Remarks

This event is fired once for each log message generated by the class. The verbosity is controlled by the LogLevel setting.

LogLevel indicates the level of message. Possible values are as follows:

The value 1 (Info) logs basic information, including the URL, HTTP version, and status details.

The value 2 (Verbose) logs additional information about the request and response.

The value 3 (Debug) logs the headers and body for both the request and response, as well as additional debug information (if any).

Message is the log entry.

LogType identifies the type of log entry. Possible values are as follows:

• "Info"
• "RequestHeaders"
• "ResponseHeaders"
• "RequestBody"
• "ResponseBody"
• "ProxyRequest"
• "ProxyResponse"
• "FirewallRequest"
• "FirewallResponse"

MultipartUploadList Event (AmazonGlacier Class)

Fires once for each multipart upload when ListMultipartUploads is called.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
virtual int FireMultipartUploadList(AmazonGlacierMultipartUploadListEventParams *e);

typedef struct {
  const char *ArchiveDescription;
  const char *CreationDate;
  const char *UploadId;
  const char *VaultArn;
  int PartSize;
  int reserved;
} AmazonGlacierMultipartUploadListEventParams;


Unicode (Windows)
virtual INT FireMultipartUploadList(AmazonGlacierMultipartUploadListEventParams *e);

typedef struct {
  LPCWSTR ArchiveDescription;
  LPCWSTR CreationDate;
  LPCWSTR UploadId;
  LPCWSTR VaultArn;
  INT PartSize;
  INT reserved;
} AmazonGlacierMultipartUploadListEventParams;

#define EID_AMAZONGLACIER_MULTIPARTUPLOADLIST 6

virtual INT CLOUDSTORAGE_CALL FireMultipartUploadList(LPSTR &lpszArchiveDescription, LPSTR &lpszCreationDate, LPSTR &lpszUploadId, LPSTR &lpszVaultArn, INT &iPartSize);

class AmazonGlacierMultipartUploadListEventParams {
public:
  const QString &ArchiveDescription();

  const QString &CreationDate();

  const QString &UploadId();

  const QString &VaultArn();

  int PartSize();

  int EventRetVal();
  void SetEventRetVal(int iRetVal);
};

// To handle, connect one or more slots to this signal.
void MultipartUploadList(AmazonGlacierMultipartUploadListEventParams *e);

// Or, subclass AmazonGlacier and override this emitter function.
virtual int FireMultipartUploadList(AmazonGlacierMultipartUploadListEventParams *e) {...}

Remarks

This event fires for each multipart upload returned when calling ListMultipartUploads.

ArchiveDescription is the archive description (if any).

CreationDate is the UTC time that the multipart upload was started. This is a string representation of ISO 8601 date format. For example: "2012-03-20T17:03:43.221Z".

UploadId is the Id of the multipart upload.

VaultArn is the Amazon Resource Name (ARN) of the Vault in which the archive is created.

PartSize is the part size in bytes. This is specified by the PartSize setting and is used when StartMultipartUpload is called.

PartList Event (AmazonGlacier Class)

Fires once for each part when calling ListParts.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
virtual int FirePartList(AmazonGlacierPartListEventParams *e);

typedef struct {
  const char *ArchiveDescription;
  const char *CreationDate;
  const char *UploadId;
  int64 StartPosition;
  int64 Size;
  const char *SHA256TreeHash;
  const char *VaultArn;
  int reserved;
} AmazonGlacierPartListEventParams;


Unicode (Windows)
virtual INT FirePartList(AmazonGlacierPartListEventParams *e);

typedef struct {
  LPCWSTR ArchiveDescription;
  LPCWSTR CreationDate;
  LPCWSTR UploadId;
  LONG64 StartPosition;
  LONG64 Size;
  LPCWSTR SHA256TreeHash;
  LPCWSTR VaultArn;
  INT reserved;
} AmazonGlacierPartListEventParams;

#define EID_AMAZONGLACIER_PARTLIST 7

virtual INT CLOUDSTORAGE_CALL FirePartList(LPSTR &lpszArchiveDescription, LPSTR &lpszCreationDate, LPSTR &lpszUploadId, LONG64 &lStartPosition, LONG64 &lSize, LPSTR &lpszSHA256TreeHash, LPSTR &lpszVaultArn);

class AmazonGlacierPartListEventParams {
public:
  const QString &ArchiveDescription();

  const QString &CreationDate();

  const QString &UploadId();

  qint64 StartPosition();

  qint64 Size();

  const QString &SHA256TreeHash();

  const QString &VaultArn();

  int EventRetVal();
  void SetEventRetVal(int iRetVal);
};

// To handle, connect one or more slots to this signal.
void PartList(AmazonGlacierPartListEventParams *e);

// Or, subclass AmazonGlacier and override this emitter function.
virtual int FirePartList(AmazonGlacierPartListEventParams *e) {...}

Remarks

This event fires once for each part when calling ListParts.

ArchiveDescription is the description of the archive (if any).

CreationDate is the UTC time that the multipart upload was started. This is a string representation of ISO 8601 date format. For example: "2012-03-20T17:03:43.221Z".

UploadId is the Id of the multipart upload associated with this part.

StartPosition is the byte offset in the archive of the current part.

Size is the part size in bytes.

SHA256TreeHash is the SHA256 tree hash value that Amazon calculated for the part.

VaultArn is the Amazon Resource Name (ARN) of the Vault in which the archive is created.

Progress Event (AmazonGlacier Class)

Fires during an upload or download to indicate transfer progress.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
virtual int FireProgress(AmazonGlacierProgressEventParams *e);

typedef struct {
  int Direction;
  int64 BytesTransferred;
  int64 TotalBytes;
  int PercentDone;
  int reserved;
} AmazonGlacierProgressEventParams;


Unicode (Windows)
virtual INT FireProgress(AmazonGlacierProgressEventParams *e);

typedef struct {
  INT Direction;
  LONG64 BytesTransferred;
  LONG64 TotalBytes;
  INT PercentDone;
  INT reserved;
} AmazonGlacierProgressEventParams;

#define EID_AMAZONGLACIER_PROGRESS 8

virtual INT CLOUDSTORAGE_CALL FireProgress(INT &iDirection, LONG64 &lBytesTransferred, LONG64 &lTotalBytes, INT &iPercentDone);

class AmazonGlacierProgressEventParams {
public:
  int Direction();

  qint64 BytesTransferred();

  qint64 TotalBytes();

  int PercentDone();

  int EventRetVal();
  void SetEventRetVal(int iRetVal);
};

// To handle, connect one or more slots to this signal.
void Progress(AmazonGlacierProgressEventParams *e);

// Or, subclass AmazonGlacier and override this emitter function.
virtual int FireProgress(AmazonGlacierProgressEventParams *e) {...}

Remarks

This event fires during an upload or download to indicate the progress of the transfer of the entire request. By default, this event will fire each time PercentDone increases by one percent; the ProgressStep configuration setting can be used to alter this behavior.

Direction indicates whether the transfer is an upload (0) or a download (1).

BytesTransferred reflects the number of bytes that have been transferred so far, or 0 if the transfer is starting (however, see note below).

TotalBytes reflects the total number of bytes that are to be transferred, or -1 if the total is unknown. This amount includes the size of everything in the request like HTTP headers.

PercentDone reflects the overall progress of the transfer, or -1 if the progress cannot be calculated.

Note: By default, the class tracks transfer progress absolutely. If a transfer is interrupted and later resumed, the values reported by this event upon and after resumption will account for the data that was transferred before the interruption.

For example, if 10MB of data was successfully transferred before the interruption, then this event will fire with a BytesTransferred value of 10485760 (10MB) when the transfer is first resumed, and then continue to fire with successively greater values as usual.

This behavior can be changed by disabling the ProgressAbsolute configuration setting, in which case the class will treat resumed transfers as "new" transfers. In this case, the BytesTransferred parameter will always be 0 the first time this event fires, regardless of whether the transfer is new or being resumed.

SSLServerAuthentication Event (AmazonGlacier Class)

Fired after the server presents its certificate to the client.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
virtual int FireSSLServerAuthentication(AmazonGlacierSSLServerAuthenticationEventParams *e);

typedef struct {
  const char *CertEncoded;
  int lenCertEncoded;
  const char *CertSubject;
  const char *CertIssuer;
  const char *Status;
  int Accept;
  int reserved;
} AmazonGlacierSSLServerAuthenticationEventParams;


Unicode (Windows)
virtual INT FireSSLServerAuthentication(AmazonGlacierSSLServerAuthenticationEventParams *e);

typedef struct {
  LPCSTR CertEncoded;
  INT lenCertEncoded;
  LPCWSTR CertSubject;
  LPCWSTR CertIssuer;
  LPCWSTR Status;
  BOOL Accept;
  INT reserved;
} AmazonGlacierSSLServerAuthenticationEventParams;

#define EID_AMAZONGLACIER_SSLSERVERAUTHENTICATION 9

virtual INT CLOUDSTORAGE_CALL FireSSLServerAuthentication(LPSTR &lpCertEncoded, INT &lenCertEncoded, LPSTR &lpszCertSubject, LPSTR &lpszCertIssuer, LPSTR &lpszStatus, BOOL &bAccept);

class AmazonGlacierSSLServerAuthenticationEventParams {
public:
  const QByteArray &CertEncoded();

  const QString &CertSubject();

  const QString &CertIssuer();

  const QString &Status();

  bool Accept();
  void SetAccept(bool bAccept);

  int EventRetVal();
  void SetEventRetVal(int iRetVal);
};

// To handle, connect one or more slots to this signal.
void SSLServerAuthentication(AmazonGlacierSSLServerAuthenticationEventParams *e);

// Or, subclass AmazonGlacier and override this emitter function.
virtual int FireSSLServerAuthentication(AmazonGlacierSSLServerAuthenticationEventParams *e) {...}

Remarks

During this event, the client can decide whether or not to continue with the connection process. The Accept parameter is a recommendation on whether to continue or close the connection. This is just a suggestion: application software must use its own logic to determine whether or not to continue.

When Accept is False, Status shows why the verification failed (otherwise, Status contains the string OK). If it is decided to continue, you can override and accept the certificate by setting the Accept parameter to True.

SSLStatus Event (AmazonGlacier Class)

Fired when secure connection progress messages are available.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
virtual int FireSSLStatus(AmazonGlacierSSLStatusEventParams *e);

typedef struct {
  const char *Message;
  int reserved;
} AmazonGlacierSSLStatusEventParams;


Unicode (Windows)
virtual INT FireSSLStatus(AmazonGlacierSSLStatusEventParams *e);

typedef struct {
  LPCWSTR Message;
  INT reserved;
} AmazonGlacierSSLStatusEventParams;

#define EID_AMAZONGLACIER_SSLSTATUS 10

virtual INT CLOUDSTORAGE_CALL FireSSLStatus(LPSTR &lpszMessage);

class AmazonGlacierSSLStatusEventParams {
public:
  const QString &Message();

  int EventRetVal();
  void SetEventRetVal(int iRetVal);
};

// To handle, connect one or more slots to this signal.
void SSLStatus(AmazonGlacierSSLStatusEventParams *e);

// Or, subclass AmazonGlacier and override this emitter function.
virtual int FireSSLStatus(AmazonGlacierSSLStatusEventParams *e) {...}

Remarks

The event is fired for informational and logging purposes only. This event tracks the progress of the connection.

StartTransfer Event (AmazonGlacier Class)

This event fires when a document starts transferring (after the headers).

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
virtual int FireStartTransfer(AmazonGlacierStartTransferEventParams *e);

typedef struct {
  int Direction;
  int reserved;
} AmazonGlacierStartTransferEventParams;


Unicode (Windows)
virtual INT FireStartTransfer(AmazonGlacierStartTransferEventParams *e);

typedef struct {
  INT Direction;
  INT reserved;
} AmazonGlacierStartTransferEventParams;

#define EID_AMAZONGLACIER_STARTTRANSFER 11

virtual INT CLOUDSTORAGE_CALL FireStartTransfer(INT &iDirection);

class AmazonGlacierStartTransferEventParams {
public:
  int Direction();

  int EventRetVal();
  void SetEventRetVal(int iRetVal);
};

// To handle, connect one or more slots to this signal.
void StartTransfer(AmazonGlacierStartTransferEventParams *e);

// Or, subclass AmazonGlacier and override this emitter function.
virtual int FireStartTransfer(AmazonGlacierStartTransferEventParams *e) {...}

Remarks

The StartTransfer event is fired when the document text starts transferring from the server to the local host.

The Direction parameter shows whether the client (0) or the server (1) is sending the data.

Transfer Event (AmazonGlacier Class)

Fired while a document transfers (delivers document).

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
virtual int FireTransfer(AmazonGlacierTransferEventParams *e);

typedef struct {
  int Direction;
  int64 BytesTransferred;
  int PercentDone;
  const char *Text;
  int lenText;
  int reserved;
} AmazonGlacierTransferEventParams;


Unicode (Windows)
virtual INT FireTransfer(AmazonGlacierTransferEventParams *e);

typedef struct {
  INT Direction;
  LONG64 BytesTransferred;
  INT PercentDone;
  LPCSTR Text;
  INT lenText;
  INT reserved;
} AmazonGlacierTransferEventParams;

#define EID_AMAZONGLACIER_TRANSFER 12

virtual INT CLOUDSTORAGE_CALL FireTransfer(INT &iDirection, LONG64 &lBytesTransferred, INT &iPercentDone, LPSTR &lpText, INT &lenText);

class AmazonGlacierTransferEventParams {
public:
  int Direction();

  qint64 BytesTransferred();

  int PercentDone();

  const QByteArray &Text();

  int EventRetVal();
  void SetEventRetVal(int iRetVal);
};

// To handle, connect one or more slots to this signal.
void Transfer(AmazonGlacierTransferEventParams *e);

// Or, subclass AmazonGlacier and override this emitter function.
virtual int FireTransfer(AmazonGlacierTransferEventParams *e) {...}

Remarks

The Text parameter contains the portion of the document text being received. It is empty if data are being posted to the server.

The BytesTransferred parameter contains the number of bytes transferred in this Direction since the beginning of the document text (excluding HTTP response headers).

The Direction parameter shows whether the client (0) or the server (1) is sending the data.

The PercentDone parameter shows the progress of the transfer in the corresponding direction. If PercentDone can not be calculated the value will be -1.

Note: Events are not re-entrant. Performing time-consuming operations within this event will prevent it from firing again in a timely manner and may affect overall performance.

VaultList Event (AmazonGlacier Class)

Fires once for each vault returned when calling ListVaults.

Syntax

• C++
• C
• Qt

ANSI (Cross Platform)
virtual int FireVaultList(AmazonGlacierVaultListEventParams *e);

typedef struct {
  const char *CreationDate;
  const char *LastInventoryDate;
  const char *VaultArn;
  const char *VaultName;
  int ArchiveCount;
  int64 Size;
  int reserved;
} AmazonGlacierVaultListEventParams;


Unicode (Windows)
virtual INT FireVaultList(AmazonGlacierVaultListEventParams *e);

typedef struct {
  LPCWSTR CreationDate;
  LPCWSTR LastInventoryDate;
  LPCWSTR VaultArn;
  LPCWSTR VaultName;
  INT ArchiveCount;
  LONG64 Size;
  INT reserved;
} AmazonGlacierVaultListEventParams;

#define EID_AMAZONGLACIER_VAULTLIST 13

virtual INT CLOUDSTORAGE_CALL FireVaultList(LPSTR &lpszCreationDate, LPSTR &lpszLastInventoryDate, LPSTR &lpszVaultArn, LPSTR &lpszVaultName, INT &iArchiveCount, LONG64 &lSize);

class AmazonGlacierVaultListEventParams {
public:
  const QString &CreationDate();

  const QString &LastInventoryDate();

  const QString &VaultArn();

  const QString &VaultName();

  int ArchiveCount();

  qint64 Size();

  int EventRetVal();
  void SetEventRetVal(int iRetVal);
};

// To handle, connect one or more slots to this signal.
void VaultList(AmazonGlacierVaultListEventParams *e);

// Or, subclass AmazonGlacier and override this emitter function.
virtual int FireVaultList(AmazonGlacierVaultListEventParams *e) {...}

Remarks

This event fires once for each vault returned when calling ListVaults.

CreationDate is the date the vault was created, in Coordinated Universal Time (UTC). This is a string representation of ISO 8601 date format, for example: 2012-03-20T17:03:43.221Z.

LastInventoryDate is the date of the last vault inventory, in Coordinated Universal Time (UTC). This is a string representation of ISO 8601 date format, for example: 2012-03-20T17:03:43.221Z.

VaultArn is the Amazon Resource Name (ARN) of the vault.

VaultName is the name of the vault.

ArchiveCount is the number of archives in the vault as of LastInventoryDate.

Size is the size of all the archives (including any per-archive overhead) in the vault, as of the last inventory date.

Certificate Type

This is the digital certificate being used.

Syntax

CloudStorageCertificate (declared in cloudstorage.h)

Remarks

This type describes the current digital certificate. The certificate may be a public or private key. The fields are used to identify or select certificates.

Fields

Constructors

Certificate()

Certificate(const char* lpEncoded, int lenEncoded)

Certificate(int iStoreType, const char* lpStore, int lenStore, const char* lpszStorePassword, const char* lpszSubject)

Firewall Type

The firewall the component will connect through.

Syntax

CloudStorageFirewall (declared in cloudstorage.h)

Remarks

When connecting through a firewall, this type is used to specify different properties of the firewall, such as the firewall Host and the FirewallType.

Fields

Constructors

Firewall()

GlacierJob Type

This type holds details about the job.

Syntax

CloudStorageGlacierJob (declared in cloudstorage.h)

Remarks

This type holds details about the job.

Fields

Constructors

GlacierJob()

GlacierJob(int iType, const char* lpszArchiveId, int64 lArchiveSize, const char* lpszArchiveSHA256TreeHash, int bCompleted, const char* lpszCompletionDate, const char* lpszCreationDate, const char* lpszDescription, const char* lpszJobId, const char* lpszSNSTopic, const char* lpszSHA256TreeHash, int iStatusCode, const char* lpszStatusMessage, const char* lpszVaultArn, int64 lInventorySize)

GlacierMultipartUpload Type

This type holds details about the multipart upload.

Syntax

CloudStorageGlacierMultipartUpload (declared in cloudstorage.h)

Remarks

This type holds details about the multipart upload.

Fields

Constructors

GlacierMultipartUpload()

GlacierMultipartUpload(const char* lpszArchiveDescription, const char* lpszCreationDate, const char* lpszUploadId, const char* lpszVaultArn, int iPartSize)

GlacierNotification Type

This type holds notification information.

Syntax

CloudStorageGlacierNotification (declared in cloudstorage.h)

Remarks

This type holds notification information.

Fields

Constructors

GlacierNotification()

GlacierNotification(int iEventType, const char* lpszSNSTopic)

GlacierPart Type

This type holds details about the part.

Syntax

CloudStorageGlacierPart (declared in cloudstorage.h)

Remarks

This type holds details about the part.

Fields

Constructors

GlacierPart()

GlacierPart(const char* lpszArchiveDescription, const char* lpszCreationDate, const char* lpszUploadId, int64 lStartPosition, int64 lSize, const char* lpszSHA256TreeHash, const char* lpszVaultArn)

GlacierVault Type

This type holds vault information.

Syntax

CloudStorageGlacierVault (declared in cloudstorage.h)

Remarks

This type holds vault information.

Fields

Constructors

GlacierVault()

GlacierVault(const char* lpszArn, const char* lpszName, const char* lpszCreationDate, const char* lpszLastInventoryDate, int iArchiveCount, int64 lSize)

Header Type

This is an HTTP header as it is received from the server.

Syntax

CloudStorageHeader (declared in cloudstorage.h)

Remarks

When a header is received through a Header event, it is parsed into a Header type. This type contains a Field, and its corresponding Value.

Fields

Constructors

Header()

Header(const char* lpszField, const char* lpszValue)

Proxy Type

The proxy the component will connect to.

Syntax

CloudStorageProxy (declared in cloudstorage.h)

Remarks

When connecting through a proxy, this type is used to specify different properties of the proxy, such as the Server and the AuthScheme.

Fields

Constructors

Proxy()

Proxy(const char* lpszServer, int iPort)

Proxy(const char* lpszServer, int iPort, const char* lpszUser, const char* lpszPassword)

CloudStorageList Type

Syntax

CloudStorageList<T> (declared in cloudstorage.h)

Remarks

CloudStorageList is a generic class that is used to hold a collection of objects of type T, where T is one of the custom types supported by the AmazonGlacier class.

int GetCount() {}

int SetCount(int count) {}

T* Get(int index) {}

T* Set(int index, T* value) {}

CloudStorageStream Type

Syntax

CloudStorageStream (declared in cloudstorage.h)

Remarks

The AmazonGlacier class includes one or more API members that take a stream object as a parameter. To use such API members, create a concrete class that implements the CloudStorageStream interface and pass the AmazonGlacier class an instance of that concrete class.

When implementing the CloudStorageStream interface's properties and methods, they must behave as described below. If the concrete class's implementation does not behave as expected, undefined behavior may occur.

bool CanRead() { return true; }

bool CanSeek() { return true; }

bool CanWrite() { return true; }

int64 GetLength() = 0;

void Close() {}

int Flush() { return 0; }

int Read(void* buffer, int count) = 0;

int64 Seek(int64 offset, int seekOrigin) = 0;

int Write(const void* buffer, int count) = 0;

Config Settings (AmazonGlacier Class)

AmazonGlacier Config Settings

HTTP Config Settings