libmapipp::folder Class Reference

This class represents a folder or container within Exchange. More...

#include <folder.h>

Inheritance diagram for libmapipp::folder:
libmapipp::object

Public Types

typedef boost::shared_ptr< folderfolder_shared_ptr
 Pointer to a folder. More...
 
typedef std::vector
< folder_shared_ptr
hierarchy_container_type
 Hierarchy folders. More...
 
typedef std::vector
< message_shared_ptr
message_container_type
 
typedef boost::shared_ptr
< message
message_shared_ptr
 Pointer to a message. More...
 

Public Member Functions

void delete_message (mapi_id_t message_id) throw (mapi_exception)
 Delete a message that belongs to this folder. More...
 
hierarchy_container_type fetch_hierarchy () throw (mapi_exception)
 Fetch all subfolders within this folder. More...
 
message_container_type fetch_messages () throw (mapi_exception)
 Fetch all messages in this folder. More...
 
 folder (object &parent_folder, const mapi_id_t folder_id) throw (mapi_exception)
 Constructor. More...
 
mapi_id_t get_id () const
 Obtain folder id. More...
 
virtual ~folder () throw ()
 Destructor. More...
 
- Public Member Functions inherited from libmapipp::object
virtual mapi_object_t & data () throw ()
 Obtain a reference to the mapi_object_t associated with this object. More...
 
virtual property_container get_property_container ()
 Obtain a property_container to be used with this object. More...
 
virtual sessionget_session ()
 Obtain the session associated with this object. More...
 
 object (session &mapi_session, const std::string &object_type="") throw ()
 Object Constructor. More...
 
virtual ~object () throw ()
 Destructor. More...
 

Additional Inherited Members

- Protected Attributes inherited from libmapipp::object
mapi_object_t m_object
 
sessionm_session
 

Detailed Description

This class represents a folder or container within Exchange.

Examples:
attach_test.cpp, foldertree.cpp, messages.cpp, and test.cpp.

Member Typedef Documentation

typedef boost::shared_ptr<folder> libmapipp::folder::folder_shared_ptr

Pointer to a folder.

Hierarchy folders.

This is a vector (list) of child folders for a given folder

typedef boost::shared_ptr<message> libmapipp::folder::message_shared_ptr

Pointer to a message.

Constructor & Destructor Documentation

libmapipp::folder::folder ( object parent_folder,
const mapi_id_t  folder_id 
)
throw (mapi_exception
)
inline

Constructor.

Parameters
parent_folderThe parent of this folder.
folder_idThis folder's id.

References libmapipp::object::m_object.

virtual libmapipp::folder::~folder ( )
throw (
)
inlinevirtual

Destructor.

Member Function Documentation

void libmapipp::folder::delete_message ( mapi_id_t  message_id)
throw (mapi_exception
)
inline

Delete a message that belongs to this folder.

Parameters
message_idThe id of the message to delete.

References libmapipp::object::m_object.

hierarchy_container_type libmapipp::folder::fetch_hierarchy ( )
throw (mapi_exception
)

Fetch all subfolders within this folder.

Returns
A container of folder shared pointers.
Examples:
attach_test.cpp, foldertree.cpp, and test.cpp.
message_container_type libmapipp::folder::fetch_messages ( )
throw (mapi_exception
)

Fetch all messages in this folder.

Returns
A container of message shared pointers.
Examples:
attach_test.cpp, messages.cpp, and test.cpp.
mapi_id_t libmapipp::folder::get_id ( ) const
inline

Obtain folder id.

Returns
This folder's id.
Examples:
attach_test.cpp, and test.cpp.

The documentation for this class was generated from the following file:

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