Extended MAPI has been a long requested enhancement for PowerBuilder.
In PowerBuilder 12.6 Extended MAPI was implemented with the interface unchanged. This means that existing PowerBuilder applications will continue to work without modifying the Powerscript source code. Most mail object related functions and properties are identical to Simple MAPI with only a few changes that are described below.
PB 12.6 Extended MAPI changes to the Mailsession object:
(1) function mailReadMessage( messageid, mailmessage, readoption, mark )
For the readoption argument, value mailBodyAsFile! is not supported for Extended MAPI. It will work as mailEntireMessage! if used in powerscript code.
(2) function mailResolveRecipient ( recipient {, allowupdates } )
The optional argument allowupdates is always false for Extended MAPI.
(3) function mailRecipientDetails ( mailrecipient {, allowupdates } )
The optional argument allowupdates is always true for Extended MAPI.
PB 12.6 Extended MAPI changes to the mailFileDescriptionobject
(1 (1) FileTypeProperty
Only mailAttach! is supported for Extended MAPI, it will assume this value if you specify one other value (mailOLE! or mailOLEStatic! ).
If the Windows operating system being used does not support Extended MAPI, PowerBuilder 12.6 will use the legacy Simple MAPI.
64-bit PowerBuilder mail applications can only work with 64-bit Windows MAPI. 32-bit PowerBuilder applications can only work with 32-bit Windows MAPI.
Known Issues
CR 780378 – PB 12.6 GA through EBF 24160 (build 4035)
Regression when mail is sent from PB 12.6, a copy of the mail sent is not placed in the senders Outlook folder. This issue has been addressed in PWRBLDR126000P_4-71000192.ZIP EBF 24672: 12.6 SP00 PL04 (build 4058) that is now available for download.
CR 781930 - PB 12.6 GA through EBF 24160 (build 4035) With PB 12.6 implementing Extended MAPI a need has arisen to also support Simple MAPI if the default mail client does not support Extended MAPI. This issue has been addressed in PWRBLDR126000P_4-71000192.ZIP EBF 24672: 12.6 SP00 PL04 (build 4058) that is now available for download. The fix was tested with Mozilla Thunderbird.
CR 791349 - PB 12.6 GA through EBF 25011 (build 4081) Feature added in EBF 25581 (build 4088) to allow PB 12.6 with Extended MAPI implementation to use Simple MAPI. In some environments the above fix was not working such as when a machine had multiple email clients installed. EBF 25581 12.6 SP00 PL05 (build 4088) includes an option to use Simple MAPI.
To use Simple MAPI in PB 12.6 build 4088 and above:
1 - In the PB IDE, add the following to the [PB] section of your pb.ini that PB uses for initialzation.
[PB]
UseSimpleMAPI=yes
Default location of pb.ini for PB 12.6 on Windows 7/8.1 is C:\Users\username\AppData\Local\Sybase\PowerBuilder 12.6.
2 - For a deployed application, create a text file named pb.ini with the text above and deploy it with your application executable.
