vuSaveProfile
Purpose
Save the current active runtime values into the managed profile named default.
This is the normal Basic-safe profile save function used by the setup wizard and by single-profile applications.
Export name
Clarion prototype (Inside Global MAP)
- vuSaveProfile(),LONG,PROC,PASCAL,RAW,NAME(‘vuSaveProfile’)
Parameters
Return value
- 1 = success
- 0 = save 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
vuSaveProfile() saves the current live runtime configuration into the internal managed profile key default.
That includes the current settings already loaded or set in memory, such as:
- SMTP server and port
- login and security settings
- POP settings where applicable
- profile metadata
- secrets through the managed secret store
After a successful save:
- the default managed profile becomes the active profile
- the current process immediately applies that saved managed profile
- a same-session send can use the saved profile without requiring an application restart
Clarion example
Result LONG
Result = vuSaveProfile()
Notes
- This is the normal profile-save function for the Basic edition.
- It does not save to the old vuMail registry model once managed profiles are active.
- Use vuSaveProfileEx(ProfileName) only when you need named profiles and have the required license tier.
- In the normal wizard flow, this is the function that transitions the application into managed-profile-based persistence.