MAPIC++ClientLibraryBindings 2.0 API Documentation

- Main Page
- Related Pages
- Namespaces
- Classes
- Examples

foldertree.cpp

    This example lists the top level folders in the message store,

with output like:

Message store display name: Mailbox - Test User1
|-----> Calendar (0 items, 0 unread)
|-----> Contacts (0 items, 0 unread)
|-----> Deleted Items (0 items, 0 unread)
|-----> Drafts (0 items, 0 unread)
|-----> Inbox (26 items, 24 unread)
|-----> Journal (0 items, 0 unread)
|-----> Notes (0 items, 0 unread)
|-----> Outbox (9 items, 0 unread)
|-----> Sent Items (0 items, 0 unread)
|-----> Tasks (0 items, 0 unread)

The example shows how to create a session, get the message_store, get properties of the message store, and then gets the list of child folders and some associated folder properties.

/*
libmapi C++ Wrapper
Sample folder tree list application
Copyright (C) Brad Hards <bradh@frogmouth.net> 2008.
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
#include <exception>
#include <string>
#include <libmapi++/libmapi++.h>
int main ()
{
try {
// Initialize MAPI Session
libmapipp::session mapi_session;
// You could log in with a non-default profile here
mapi_session. login();
// Get the private (user) folders message store
libmapipp::message_store &msg_store = mapi_session. get_message_store();
// Get a property of the top level message store
libmapipp::property_container msg_store_props = msg_store. get_property_container();
msg_store_props << PR_DISPLAY_NAME; // you could use other properties here
msg_store_props. fetch();
// Display the property. You can also use a property_container_iterator
// to work through the properties, but in this case there is only one.
std::cout << "Message store display name: "
<< (const char*)msg_store_props[PR_DISPLAY_NAME]
<< std::endl;
// Fetch the folder list.
// We start off by fetching the top level folder
mapi_id_t top_folder_id = msg_store. get_default_folder(olFolderTopInformationStore);
libmapipp::folder top_folder(msg_store, top_folder_id);
// Now get the child folders of the top level folder. These are returned as
// a std::vector of pointers to folders
libmapipp::folder::hierarchy_container_type child_folders = top_folder. fetch_hierarchy();
// Display the name, total item count and unread item count for each folder
for (unsigned int i = 0; i < child_folders.size(); ++i) {
libmapipp::property_container child_props = child_folders[i]->get_property_container();
child_props << PR_DISPLAY_NAME << PR_CONTENT_COUNT << PR_CONTENT_UNREAD;
child_props.fetch();
std::cout << "|-----> " << (const char*)child_props[PR_DISPLAY_NAME]
<< " (" << (*(int*)child_props[PR_CONTENT_COUNT]) << " items, "
<< (*(int*)child_props[PR_CONTENT_UNREAD]) << " unread)"
<< std::endl;
}
}
catch (libmapipp::mapi_exception e) // Catch any MAPI exceptions
{
std::cout << "MAPI Exception in main: " << e.what()
<< std::endl;
}
catch (std::runtime_error e) // Catch any other runtime exceptions
{
std::cout << "std::runtime_error exception in main: "
<< e.what() << std::endl;
}
return 0;
}

| This content is licensed under the Creative Commons Attribution ShareAlike License v. 3.0: http://creativecommons.org/licenses/by-sa/3.0/