vuPOP3EmbeddedName()

vuPOP3EmbeddedName(LONG InIndex),CSTRING,PROC,PASCAL,RAW,NAME('vuPOP3EmbeddedName')

This legacy function is declared as returning CSTRING in Clarion to preserve original vuMail template behavior. Under the hood, the export returns a pointer to a null-terminated C string buffer, and Clarion consumes it directly as text, as shown in the examples below.

Description

Gets embedded name text for the selected item using the original vuMail compatibility behavior.

Parameters

Index (LONG): 1-based item index.

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)

Index LONG

Index = 1
MESSAGE('Embedded name: ' & vuPOP3EmbeddedName(Index))

Notes

This is a legacy compatibility exception. New text-return APIs should use caller-owned *CSTRING output buffers.

Home

All functions

Legacy functions