Sample code for 30+ languages & platforms
Unicode C++

Upload File with User-Defined Metadata

See more Amazon S3 Examples

Demonstrates how to upload a file with user-defined metadata to the Amazon S3 service.

Chilkat Unicode C++ Downloads

Unicode C++
#include <CkHttpW.h>

void ChilkatSample(void)
    {
    bool success = false;

    // This example assumes the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    CkHttpW http;

    // Insert your AWS keys here:
    http.put_AwsAccessKey(L"AWS_ACCESS_KEY");
    http.put_AwsSecretKey(L"AWS_SECRET_KEY");

    const wchar_t *bucketName = L"chilkat.ocean";
    const wchar_t *objectName = L"seahorse.jpg";
    const wchar_t *localFilePath = L"qa_data/jpg/seahorse.jpg";
    const wchar_t *contentType = L"image/jpg";

    // User-defined metadata are name/value pairs, and are added to the HTTP request header.
    // Header names must begin with "x-amz-meta-" to distinguish them from other HTTP headers.
    // Note that Amazon S3 stores user-defined metadata keys in lowercase.

    // For example, to add genus=Hippocampus, we do this:
    http.SetRequestHeader(L"x-amz-meta-genus",L"Hippocampus");

    // Add a few more user-metadata key pairs.
    http.SetRequestHeader(L"x-amz-meta-species",L"big-belly seahorse");
    http.SetRequestHeader(L"x-amz-meta-habitat",L"shallow tropical and temperate waters");

    success = http.S3_UploadFile(localFilePath,contentType,bucketName,objectName);

    if (success != true) {
        wprintf(L"%s\n",http.lastErrorText());
    }
    else {
        wprintf(L"File uploaded.\n");
    }
    }