NAME

Mail::Outlook::Folder - extension to handle Microsoft (R) Outlook (R) mail folders.

SYNOPSIS

See Mail::Outlook, as this is not meant to be used as a standalone module.

DESCRIPTION

Handles the Folder interaction with the Outlook API.

METHODS

new()

Create a new Outlook mail object. Returns the object on success or undef on failure. To see the last error use 'Win32::OLE->LastError();'.

first()

Gets the first message object in the current folder. Returns undef if no messages.

last()

Gets the last message object in the current folder. Returns undef if no messages.

next()

Gets the next message object in the current folder. Returns undef if no more messages. Must be called after a first() or last() has been intiated.

previous()

Gets the previous message object in the current folder. Returns undef if no more messages. Must be called after a first() or last() has been intiated.

BUGS, PATCHES & FIXES

There are no known bugs at the time of this release. However, if you spot a bug or are experiencing difficulties that are not explained within the POD documentation, please send an email to barbie@cpan.org or submit a bug to the RT system (http://rt.cpan.org/). However, it would help greatly if you are able to pinpoint problems or even supply a patch.

If you intend to supply a patch, please visit the following URL (and associated pages) to ensure you are using the correct objects and methods.

http://msdn.microsoft.com/library/default.asp?url=/library/en-us/off2000/html/olobjApplication.asp

This article contains some interesting background into creating mail messages via Outlook, although it is VB-centric.

http://www.exchangeadmin.com/Articles/Index.cfm?ArticleID=4657

Fixes are dependant upon their severity and my availablity. Should a fix not be forthcoming, please feel free to (politely) remind me.

FUTURE ENHANCEMENTS

A couple of items that I'd like to get working.

* X-Header support * Send without the popups (Outlook Redemption looks possible)

NOTES

This module is intended to be used on Win32 platforms only, with Microsoft (R) Outlook (R) installed.

Microsoft and Outlook are registered trademarks and the copyright 1995-2003
of Microsoft Corporation. All rights reserved.

SEE ALSO

Win32::OLE
Win32::OLE::Const

DSLIP

b - Beta testing
d - Developer
p - Perl-only
O - Object oriented
p - Standard-Perl: user may choose between GPL and Artistic

AUTHOR

Barbie, <<barbie@cpan.org> > for Miss Barbell Productions, http://www.missbarbell.co.uk

COPYRIGHT AND LICENSE

Copyright (C) 2003-2005 Barbie for Miss Barbell Productions
All Rights Reserved.

This module is free software; you can redistribute it and/or 
modify it under the same terms as Perl itself.