vuMailTo(xTo, xCc, xBcc, xSubject, xBody)
Purpose
Builds a mailto: URI and asks Windows Shell to open it with the default mail client.
Parameters
- xTo (*CSTRING): To recipients string.
- xCc (*CSTRING): Cc recipients string.
- xBcc (*CSTRING): Bcc recipients string.
- xSubject (*CSTRING): Subject text.
- xBody (*CSTRING): Body text.
Return value / error codes
- Returns the Win32 ShellExecute result value.
- Values greater than 32 typically indicate the shell accepted the open request.
- 0: Exception path; details are written to vuMailLastError().
Example (Clarion)
MAP
MODULE('vuMail.dll')
vuMailTo(*CSTRING InTo,*CSTRING InCC,*CSTRING InBCC,*CSTRING InSubject,*CSTRING InBody),LONG,PROC,PASCAL,RAW,NAME('vuMailTo')
END
END
toAddr CSTRING(256)
ccAddr CSTRING(256)
bccAddr CSTRING(256)
subj CSTRING(256)
body CSTRING(512)
rc LONG
toAddr = 'user@example.com'
ccAddr = ''
bccAddr = ''
subj = 'Test message'
body = 'Hello from Clarion.'
rc = vuMailTo(toAddr, ccAddr, bccAddr, subj, body)
IF rc <= 32
MESSAGE('vuMailTo failed/was rejected by shell. rc=' & rc & ' err=' & vuMailLastError())
END
Notes
- This API opens the client compose UI; it does not send mail directly.
- Input fields are not URL-encoded by this function.
- AuthMode/OAuth is not used by this function.
- Legacy reference: vuMailDump.pdf, section heading vuMailTo.