IFolder::AddItemToInfraredFolder (Compact 7)

Article
03/14/2014

3/12/2014

The AddItemToInfraredFolder method adds an item to the list of items to send by infrared.

Note While the POOM has methods related to infrared communication, Windows Embedded Compact 7 does not support the use of infrared hardware.

Syntax

HRESULT AddItemToInfraredFolder(
    int olItem,
    IDispatch * polItem
);

Parameters

olItem
[in] Personal Information Manager (PIM) item type. One of the OlItemType enumeration values.

polItem
[in] Pointer to the PIM item you want to add to the list.

Note

You must cast the Item object to a pointer to an IDispatch interface.

Return Value

The following table shows the possible return values.

Value	Description
S_OK	The method completed successfully.
E_FAIL	The operation failed due to an unspecified error.
E_INVALIDARG	The operation failed because one or more of the arguments is not valid.
E_OUTOFMEMORY	The operation failed because it needs more memory resources.
E_UNEXPECTED	The operation failed due to an unexpected error.

Remarks

You can add any number of items of any type or combination of types to the Infrared folder. To transmit the items, call IFolder::SendToInfrared.

Code Example

The following code example shows how to add a Contact to the Infrared 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 AddContactToIrFolder(IPOutlookApp polApp, IContact * pContact)
{
    IFolder * pFolderIR;

    polApp->GetDefaultFolder(olFolderInfrared, & pFolderIR);

    pFolderIR->AddItemToInfraredFolder(olFolderContacts, (IDispatch*)pContact);
}

Requirements

Header	pimstore.h
Library	Pimstore.lib