vuMailClient()
vuMailClient(),CSTRING,PROC,PASCAL,RAW,NAME('vuMailClient')
This legacy-style text helper is declared as returning LONG at the Clarion boundary. The numeric return value is actually the address of a null-terminated C string buffer and can be consumed directly in Clarion string expressions.
Description
Gets the default mail client name using the original vuMail compatibility behavior.
Return value / error codes
- Returns the default mail client name using the original vuMail legacy text-return style.
- In Clarion, this function can be used directly in text expressions such as MESSAGE() and string assignment.
- If no text is available, the result may be empty.
Example (Clarion)
MESSAGE('Default mail client: ' & vuMailClient())
Notes
- Legacy compatibility exception: in the original PowerBasic vuMail code these functions exported a numeric DWORD that was actually the address of an internal C string buffer. Clarion can consume that value directly in string expressions, which is why the legacy examples use assignment and MESSAGE() style calls because the Clarion prototype is declared as CSTRING.
- New text-return APIs should use caller-owned *CSTRING output buffers.