Unicode C

Outlook -- Get Number of Emails

See more Outlook Examples

Gets the number of emails in an Outlook folder. This uses the OData $count system query option. See OData System Query Option $count for general information.

This example first gets the combined total number of messages across all folders.

Note: This example requires Chilkat v9.5.0.68 or greater.

This example applies to: Exchange Online | Office 365 | Hotmail.com | Live.com | MSN.com | Outlook.com | Passport.com

Unicode C

#include <C_CkHttpW.h>
#include <C_CkStringBuilderW.h>
#include <C_CkJsonObjectW.h>
#include <C_CkHashtableW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkHttpW http;
    HCkStringBuilderW sbResponse;
    HCkJsonObjectW json;
    HCkHashtableW htFolderMap;
    HCkStringBuilderW sbMap;
    const wchar_t *folderId;
    int totalItemCount;
    int childFolderCount;

    success = FALSE;

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

    http = CkHttpW_Create();

    //  Use your previously obtained access token here:
    //  See the following examples for getting an access token:
    //     Get Microsoft Graph OAuth2 Access Token (Azure AD v2.0 Endpoint).
    //     Get Microsoft Graph OAuth2 Access Token (Azure AD Endpoint).
    //     Refresh Access Token (Azure AD v2.0 Endpoint).
    //     Refresh Access Token (Azure AD Endpoint).

    CkHttpW_putAuthToken(http,L"MICROSOFT_GRAPH_ACCESS_TOKEN");

    sbResponse = CkStringBuilderW_Create();

    //  This gets the combined total number of emails in all folders.
    success = CkHttpW_QuickGetSb(http,L"https://graph.microsoft.com/v1.0/me/messages/$count",sbResponse);
    if ((success != TRUE) && (CkHttpW_getLastStatus(http) == 0)) {
        wprintf(L"%s\n",CkHttpW_lastErrorText(http));
        CkHttpW_Dispose(http);
        CkStringBuilderW_Dispose(sbResponse);
        return;
    }

    json = CkJsonObjectW_Create();
    CkJsonObjectW_putEmitCompact(json,FALSE);

    //  If the status code was not 200, then it failed and the response is likely JSON:
    if (CkHttpW_getLastStatus(http) != 200) {
        wprintf(L"Status code = %d\n",CkHttpW_getLastStatus(http));
        CkJsonObjectW_LoadSb(json,sbResponse);
        wprintf(L"%s\n",CkJsonObjectW_emit(json));
        wprintf(L"Failed.\n");
        CkHttpW_Dispose(http);
        CkStringBuilderW_Dispose(sbResponse);
        CkJsonObjectW_Dispose(json);
        return;
    }

    //  A success response payload contains just the integer value (it is not JSON)
    wprintf(L"Combined Total Number of Emails = %s\n",CkStringBuilderW_getAsString(sbResponse));
    wprintf(L"--\n");

    //  ---------------------------------------------------------------------------
    //  To get the number of emails in a particular folder, we need to use the folder id.
    //  

    //  In this example, we'd like to get number of messages in the folder "/Inbox/abc",
    //  but we must specify the corresponding folder_id.  The best way to do this is to create
    //  a local map of folderPaths-to-folderIds.
    //  We'll use the map created by this example:  Create Outlook Folder Map)
    htFolderMap = CkHashtableW_Create();
    sbMap = CkStringBuilderW_Create();
    CkStringBuilderW_LoadFile(sbMap,L"qa_data/outlook/folderMap.xml",L"utf-8");
    CkHashtableW_AddFromXmlSb(htFolderMap,sbMap);

    //  Get the ID for the "/Inbox/abc" folder:
    folderId = CkHashtableW_lookupStr(htFolderMap,L"/Inbox/abc");
    if (CkHashtableW_getLastMethodSuccess(htFolderMap) != TRUE) {
        wprintf(L"Folder ID not found\n");
        CkHttpW_Dispose(http);
        CkStringBuilderW_Dispose(sbResponse);
        CkJsonObjectW_Dispose(json);
        CkHashtableW_Dispose(htFolderMap);
        CkStringBuilderW_Dispose(sbMap);
        return;
    }

    CkHttpW_SetUrlVar(http,L"folder_id",folderId);

    //  Send the request get the folder information.
    //  In this case we are NOT using the $count system query option.
    success = CkHttpW_QuickGetSb(http,L"https://graph.microsoft.com/v1.0/me/mailFolders/{$folder_id}",sbResponse);
    if ((success != TRUE) && (CkHttpW_getLastStatus(http) == 0)) {
        wprintf(L"%s\n",CkHttpW_lastErrorText(http));
        CkHttpW_Dispose(http);
        CkStringBuilderW_Dispose(sbResponse);
        CkJsonObjectW_Dispose(json);
        CkHashtableW_Dispose(htFolderMap);
        CkStringBuilderW_Dispose(sbMap);
        return;
    }

    CkJsonObjectW_LoadSb(json,sbResponse);
    wprintf(L"%s\n",CkJsonObjectW_emit(json));
    wprintf(L"--\n");

    if (CkHttpW_getLastStatus(http) != 200) {
        wprintf(L"Status code = %d\n",CkHttpW_getLastStatus(http));
        wprintf(L"Failed.\n");
        CkHttpW_Dispose(http);
        CkStringBuilderW_Dispose(sbResponse);
        CkJsonObjectW_Dispose(json);
        CkHashtableW_Dispose(htFolderMap);
        CkStringBuilderW_Dispose(sbMap);
        return;
    }

    //  The successful JSON response looks like this;

    //  	{
    //  	  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('me')/mailFolders/$entity",
    //  	  "id": "AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAL8huv8AAAA=",
    //  	  "displayName": "abc",
    //  	  "parentFolderId": "AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAgEMAAAA",
    //  	  "childFolderCount": 2,
    //  	  "unreadItemCount": 0,
    //  	  "totalItemCount": 3
    //  	}
    //  

    //  Get the integer value from the JSON like this:
    totalItemCount = CkJsonObjectW_IntOf(json,L"totalItemCount");
    wprintf(L"totalItemCount = %d\n",totalItemCount);

    childFolderCount = CkJsonObjectW_IntOf(json,L"childFolderCount");
    wprintf(L"childFolderCount = %d\n",childFolderCount);

    //  etc..


    CkHttpW_Dispose(http);
    CkStringBuilderW_Dispose(sbResponse);
    CkJsonObjectW_Dispose(json);
    CkHashtableW_Dispose(htFolderMap);
    CkStringBuilderW_Dispose(sbMap);

    }