IFolder::ReceiveFromInfrared

This method is not supported in Windows CE Platform Builder 3.0.

This method initiates reception of items belonging to the folder type over the IR port.

HRESULT ReceiveFromInfrared( IPOutlookItemCollection ** ppolItems );

Parameters

  • ppolItems
    [out] Pointer to a pointer to the collection of items received over the infrared link.

Return Values

S_OK indicates success, and A_ABORT indicates that the user canceled the transfer before it was completed. If an error occurs, the appropriate HRESULT value is returned.

Remarks

This method on the Folder interface, unlike the Application method IPOutlookApp::ReceiveFromInfrared, initiates reception of items of only the current folder type. For example, if you call this method on an Appointment folder, you will only be able to receive appointments. If a 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 [Visual Basic]

The following Visual Basic® code snippet shows how to receive appointments over the IR port:

Sub ReceiveAppointments(polApp As PocketOutlook.Application)
Dim polItemsFromIR as PocketOutlook.Items
Dim polCalendarFdr as PocketOutlook.Folder
Set polCalendarFdr = polApp.GetDefaultFolder(olFolderCalendar)
Set polItemsFromIR = polCalendarFdr.ReceiveFromInfrared()
End Sub

Code Example [C++]

The following C++ code snippet shows how to receive appointments over the IR port:

void ReceiveAppointments(IPOutlookApp *polApp)
{
IFolder *pFolder;
IPOutlookItemCollection *pItemsFromIR;
polApp->GetDefaultFolder(olFolderCallendar, &pFolder)
pFolder->ReceiveFromInfrared(&pItemsFromIR);

// Release objects
pFolder->Release;
pItemsFromIR->Release;
}

Requirements

Runs On Versions Defined in Include Link to
Windows CE OS 2.0 and later pimstore.h    

See Also

IFolder::Unknown, IFolder Property Methods

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.