IFolder2 (Compact 7)

3/12/2014

The IFolder2 interface exposes properties and methods for creating and accessing individual POOM items, and for sending them over an infrared link. For information on the default folders that Outlook Mobile provides, see OlDefaultFolders.

Methods in Vtable Order

IFolder2 methods Description

IFolder2::get_ItemId

New for Windows Embedded Compact 7. Gets the folder item's item identifier (POLITEMID).

IFolder2::get_Items

Gets the list of items in a folder.

IFolder2::get_DefaultItemType

Gets the folder type.

IFolder2::get_Application

Gets a handle to the Outlook Mobile application object - the POOM entry point.

IFolder2::get_Parent

New for Windows Embedded Compact 7. Gets the folder item's parent folder.

IFolder2::get_Store

New for Windows Embedded Compact 7. Gets the folder item's store object.

IFolder2::get_DisplayName

New for Windows Embedded Compact 7. Gets the folder's display name as a string.

IFolder2::GetFolders

New for Windows Embedded Compact 7. Get the folder's collection of subfolders.

IFolder2::MoveToFolder

New for Windows Embedded Compact 7. Moves the folder beneath another folder.

IFolder2::CreateFolder

New for Windows Embedded Compact 7. Creates a new folder beneath this folder.

IFolder2::CreateItem

New for Windows Embedded Compact 7. Creates a new PIM item in this folder, and of the folder's default item type. For more information, see IFolder2::get_DefaultItemType.

IFolder2::Delete

New for Windows Embedded Compact 7. Delete this folder. Returns E_ACCESSDENIED if you attempt to delete a default folder.

IFolder2::SendToInfrared

Not supported in Windows Embedded Compact 7. Always returns E_NOTIMPL.

IFolder2::ReceiveFromInfrared

Not supported in Windows Embedded Compact 7. Always returns E_NOTIMPL.

Remarks

The IFolder2 interface was introduced in Windows Embedded Compact 7.

You can use all of the default folders to create and access individual POOM items, all except for the infrared folder.

You can use the infrared folder only to send items over the IR port.

You can use the IPOutlookApp::GetDefaultFolder method (on the main Outlook Mobile application object) to get any of the default folders.

Code Example

The following code example shows how to retrieve the Calendar folder.

Note

To make the following code example easier to read, security checking and error handling are not included. This code example should not be used in a release configuration unless it has been modified to include them.

void GetCalendarFolder(IPOutlookApplication * polApp)
{
    IFolder2 * pFolder;

    polApp->GetDefaultFolder(olFolderCalendar, &pFolder);

    // Release objects.
    pFolder->Release();
}

Requirements

Header

pimstore.h

Library

Pimstore.lib

See Also

Reference

Pocket Outlook Object Model Interfaces