vuPOP3GetFolder()
vuPOP3GetFolder(),CSTRING,PROC,PASCAL,RAW,NAME('vuPOP3GetFolder')
Description
Gets pop3 folder text using the original vuMail compatibility behavior.
Return value / error codes
- Returns text 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('POP3 folder: ' & vuPOP3GetFolder())
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.