Unicode C++

SharePoint -- Get File Metadata (File Size, Last-Modified Date/Time, etc.)

See more SharePoint Examples

Demonstrates how to get a file's metdata, which includes the file size, last-modified date/time, name, server relative URL, etc. Unicode C++

#include <CkHttpW.h>
#include <CkJsonObjectW.h>
#include <CkDateTimeW.h>
#include <CkDtObjW.h>

void ChilkatSample(void)
    {
    bool success = false;

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

    CkHttpW http;

    //  If SharePoint Windows classic authentication is used, then set the 
    //  Login, Password, LoginDomain, and NtlmAuth properties.
    http.put_Login(L"SHAREPOINT_USERNAME");
    http.put_Password(L"SHAREPOINT_PASSWORD");
    http.put_LoginDomain(L"SHAREPOINT_NTLM_DOMAIN");
    http.put_NtlmAuth(true);

    //  The more common case is to use SharePoint Online authentication (via the SPOIDCRL cookie).
    //  If so, do not set Login, Password, LoginDomain, and NtlmAuth, and instead
    //  establish the cookie as shown at SharePoint Online Authentication

    //  Indicate that we want a JSON reply
    http.put_Accept(L"application/json;odata=verbose");
    http.put_AcceptCharset(L"utf-8");

    const wchar_t *url = L"https://SHAREPOINT_HTTPS_DOMAIN/_api/web/GetFileByServerRelativeUrl('/Documents/VCAC-document.docx')";

    const wchar_t *jsonReply = http.quickGetStr(url);
    if (http.get_LastMethodSuccess() == false) {
        wprintf(L"%s\n",http.lastErrorText());
        return;
    }

    //  Examine the file's metadata in JSON format.
    CkJsonObjectW json;
    json.Load(jsonReply);
    json.put_EmitCompact(false);

    //  Make sure it was a success response, and that we really have metadata.
    //  If it was an error response, then the JSON is error information..
    if (http.get_LastStatus() != 200) {
        wprintf(L"%s\n",json.emit());
        wprintf(L"Failed.\n");
        return;
    }

    wprintf(L"%s\n",json.emit());

    wprintf(L"--------\n");
    wprintf(L"Server relative URL: %s\n",json.stringOf(L"d.ServerRelativeUrl"));

    int fileSize = json.IntOf(L"d.Length");
    wprintf(L"File Size = %d\n",fileSize);

    CkDateTimeW lastmod;
    lastmod.SetFromTimestamp(json.stringOf(L"d.TimeLastModified"));

    //  Once we have the CkDateTime object, we can get the date/time in all sorts of formats:

    //  Get as a RFC822 GMT string:
    bool bLocalTime = false;
    wprintf(L"%s\n",lastmod.getAsRfc822(bLocalTime));

    //  Get as an RFC822 string in the local timezone.
    //  (remember, the daylight savings that existed at the given time in the past is applied)
    bLocalTime = true;
    wprintf(L"%s\n",lastmod.getAsRfc822(bLocalTime));

    //  Get as a 32-bit UNIX time (local or GMT..)
    //  The Unix time is number of seconds since the Epoch, 1970-01-01 00:00:00 +0000 (UTC). 
    int unixTime = lastmod.GetAsUnixTime(bLocalTime);
    wprintf(L"Unix time: %d\n",unixTime);

    //  One can also get the as a "DtObj" object for accessing the individual
    //  parts of the date/time, such as month, day, year, hour, minute, etc.
    //  The DtObj can be obtained in the GMT or local timezone:
    CkDtObjW dtObj;
    lastmod.ToDtObj(bLocalTime,dtObj);

    if (lastmod.get_LastMethodSuccess() == false) {
        wprintf(L"This should never really happen!\n");
        return;
    }

    wprintf(L"%d-%d-%d %d:%d:%d\n",dtObj.get_Day(),dtObj.get_Month(),dtObj.get_Year(),dtObj.get_Hour(),dtObj.get_Minute(),dtObj.get_Second());

    //  -------------------------------------------------
    //  The file's metadata look like this:

    //  { 
    //    "d": { 
    //      "__metadata": { 
    //        "id": "Web/GetFileByServerRelativeUrl('/Documents/VCAC-document.docx')",
    //        "uri": "https://SHAREPOINT_HTTPS_DOMAIN/_api/Web/GetFileByServerRelativeUrl('/Documents/VCAC-document.docx')",
    //        "type": "SP.File"
    //      },
    //      "Author": { 
    //        "__deferred": { 
    //          "uri": "https://SHAREPOINT_HTTPS_DOMAIN/_api/Web/GetFileByServerRelativeUrl('/Documents/VCAC-document.docx')/Author"
    //        }
    //      },
    //      "CheckedOutByUser": { 
    //        "__deferred": { 
    //          "uri": "https://SHAREPOINT_HTTPS_DOMAIN/_api/Web/GetFileByServerRelativeUrl('/Documents/VCAC-document.docx')/CheckedOutByUser"
    //        }
    //      },
    //      "ListItemAllFields": { 
    //        "__deferred": { 
    //          "uri": "https://SHAREPOINT_HTTPS_DOMAIN/_api/Web/GetFileByServerRelativeUrl('/Documents/VCAC-document.docx')/ListItemAllFields"
    //        }
    //      },
    //      "LockedByUser": { 
    //        "__deferred": { 
    //          "uri": "https://SHAREPOINT_HTTPS_DOMAIN/_api/Web/GetFileByServerRelativeUrl('/Documents/VCAC-document.docx')/LockedByUser"
    //        }
    //      },
    //      "ModifiedBy": { 
    //        "__deferred": { 
    //          "uri": "https://SHAREPOINT_HTTPS_DOMAIN/_api/Web/GetFileByServerRelativeUrl('/Documents/VCAC-document.docx')/ModifiedBy"
    //        }
    //      },
    //      "Versions": { 
    //        "__deferred": { 
    //          "uri": "https://SHAREPOINT_HTTPS_DOMAIN/_api/Web/GetFileByServerRelativeUrl('/Documents/VCAC-document.docx')/Versions"
    //        }
    //      },
    //      "CheckInComment": "",
    //      "CheckOutType": 2,
    //      "ContentTag": "{E2F05E75-B3EF-4826-8284-E572D3628A7D},9,10",
    //      "CustomizedPageStatus": 0,
    //      "ETag": "\"{E2F05E75-B3EF-4826-8284-E572D3628A7D},9\"",
    //      "Exists": true,
    //      "Length": "21082",
    //      "Level": 2,
    //      "MajorVersion": 0,
    //      "MinorVersion": 3,
    //      "Name": "VCAC-document.docx",
    //      "ServerRelativeUrl": "/Documents/VCAC-document.docx",
    //      "TimeCreated": "2016-03-04T12:38:01Z",
    //      "TimeLastModified": "2017-01-16T04:44:31Z",
    //      "Title": "",
    //      "UIVersion": 3,
    //      "UIVersionLabel": "0.3"
    //    }
    //  }
    //
    }