docs

All functions

Legacy functions

About function names

vuLoadProfileEx

Purpose

Load a named managed profile into active runtime memory.

This is the named-profile load function for Pro and Back Office workflows.

Export name

• vuLoadProfileEx

Clarion prototype (Inside Global MAP)

• vuLoadProfileEx(*CSTRING ProfileName),LONG,PROC,PASCAL,RAW,NAME('vuLoadProfileEx')

Parameters

Parameter	Type	Description	Expected values / range
ProfileName	*CSTRING	Managed profile name to load.	Example: work-account. Blank falls back to default.

Return value

• 1 = success
• 0 = load failed
• -401 = vuMailKit was not initialized
• -402 = license is invalid or initialization failed
• -403 = current license tier does not allow this feature

What it does

vuLoadProfileEx() performs an explicit managed-profile load of the named profile.

After a successful load:

• the current live runtime values are replaced by the saved values from the named profile
• the named profile becomes the active managed profile
• unsaved runtime changes from the current session are discarded

Clarion example

ProfileName              CSTRING(80)
Result                   LONG

ProfileName = 'work-account'
Result = vuLoadProfileEx(ProfileName)

Notes

• This is an explicit replace operation.
• This function is gated to Pro and Back Office editions.
• If ProfileName is blank, the load falls back to default.
• Call vuMailKitInitialize(LicenseString) at EXE startup before using this function.

All functions

Legacy functions

About function names