vuViewMail(xFilePath)
Clarion prototype
Prototype: vuViewMail(*CSTRING InFileName), SIGNED, PROC, PASCAL, RAW, NAME(‘vuViewMail’)
Purpose
Opens the specified mail file (for example .eml) using the default Windows shell association.
Parameters
- xFilePath (*CSTRING): Full path to an existing mail file.
Return value / error codes
| Value |
Meaning |
| 1 |
File open request started. |
| 0 |
Failed. Typical cases include blank path or file not found. Error details are available in vuMailLastError(). |
Example (Clarion)
mailFile CSTRING(260)
rc LONG
mailFile = 'C:\Temp\sample.eml'
rc = vuViewMail(mailFile)
IF rc = 0
MESSAGE('vuViewMail failed: ' & vuMailLastError())
END
Notes
- The file must exist before calling this function.
- This function starts an external viewer and returns immediately.
- AuthMode/OAuth is not used by this function.
- Legacy reference: vuMailDump.pdf, section heading vuViewMail.