IFolder::ReceiveFromInfrared

Article
08/28/2006

The ReceiveFromInfrared method initiates IR reception of items belonging to the folder type.

Syntax

HRESULT ReceiveFromInfrared(
  IPOutlookItemCollection ** ppolItems
);

Parameters

ppolItems
[out] Reference to the collection of items received over the infrared link.

Return Values

This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following:

S_OK
The method completed successfully.

Note Returns E_NOTIMPL in platform versions later than Windows Mobile 2003 SE.

Remarks

This method, unlike IPOutlookApp::ReceiveFromInfrared, initiates reception of items of only the current folder type. For example, if you call this method on an Appointment folder, you can only receive appointments. If a Windows Mobile–based device attempts to send a different type of item over the infrared link, the call fails. The infrared folder does not support this method.

Code Example

The following code example shows how to receive appointments over the IR port.

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 ReceiveAppointments(IPOutlookApp * polApp)
{
    IFolder * pFolder;
    IPOutlookItemCollection * pItemsFromIR;
    polApp->GetDefaultFolder(olFolderCallendar, &pFolder)
    pFolder->ReceiveFromInfrared(&pItemsFromIR);

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

Requirements

Pocket PC: Pocket PC 2000 through Windows Mobile 2003 SE (not supported in later versions)
Smartphone: Smartphone 2002 through Windows Mobile 2003 SE (not supported in later versions)
OS Versions: Windows CE 3.0 and later
Header: pimstore.h
Library: pimstore.lib