<< Click to Display Table of Contents >> Navigation:  E-Mail Functions > VpeMailDoc

[Windows platform only; not supported by the Community Edition]

Sends a mail with the current Mail-Properties.

int VpeMailDoc(

VpeHandle hDoc

)

VpeHandle hDoc

Document Handle

Returns:

Remarks:

In case of an error, LastError is set.

 

The name of the default attachment is either the DevJobName (if it is set), or the title of the VPE preview window.

 

There are some problems with MAPI clients (e-mail software). This may cause that MailDoc() will return an error and / or that the e-mail button in the toolbar is disabled (grayed).

 

Recipients, subject, text and attachments specified by code will be shown in the MAPI client dialog (for example Microsoft Exchange or Outlook).

 

Not all MAPI clients return correct error codes. Some of them return "success", even if the user aborted. Others return "common failure“ if an attached file is not existing, instead of "attachment not found", etc.

 

Netscape Messenger and the Mozilla mail client seem not to work correctly as MAPI clients.

 

MAPI clients are manufactured by vendors independent of IDEAL Software; we make no warranty, implied or otherwise, regarding these product’s performance or reliability.

 

Special care must be taken, when creating VPE Document files (mailing a VPE Document means that a VPE Document file is created automatically) that contain picturesor UDO's.
For details please see VpeWriteDoc.

Example:

VpeSetMailSubject(hDoc, "VPE Demo")

VpeAddMailReceiver(hDoc, "MrX@dummyxyz.com", VMAIL_TO)

VpeAddMailReceiver(hDoc, "MrY@dummyxyz.com", VMAIL_CC)

VpeAddMailAttachment(hDoc, "c:\data\report.vpe", 0)

VpeMailDoc(hDoc)

 

 

VpeAddMailReceiver(hDoc, "[FAX: +49 1234 12345678]", VMAIL_TO)

VpeMailDoc(hDoc)

Will FAX the message to the given phone number! If a VPE Document is attached to the mail, the VISIBLE CONTENT of the document will be faxed. Requires MS-MAIL and MS-FAX, or a similar MAPI- Mail / Fax software to be installed on the system. Also the VPE Document viewer VPE View (see "VPE View - the Document Viewer" in the Programmer's Manual) needs to be correctly installed, otherwise VPE Document attachments will not be faxed with their visual content.