vuGlobalsGetEmailFolder(xFolder)
Purpose
Copies the current runtime EmailFolder (save folder) path into a caller-provided buffer.
Parameters
xFolder (*CSTRING): Output buffer that receives the folder path.
Return value / error codes
Example (Clarion)
MAP
MODULE('vuMail.dll')
vuGlobalsGetEmailFolder(*CSTRING OutFolder),SIGNED,PROC,PASCAL,RAW,NAME('vuGlobalsGetEmailFolder')
END
END
folder CSTRING(520)
rc LONG
CLEAR(folder)
rc = vuGlobalsGetEmailFolder(folder)
IF rc = 1
MESSAGE('Email folder=' & folder)
ELSE
MESSAGE('vuGlobalsGetEmailFolder failed: ' & vuMailLastError())
END
Notes
- Legacy alias: vuGetSaveFolder().
- Value is returned from in-memory globals (load with
vuGlobalsLoad() if needed).
- AuthMode/OAuth is not used by this function.
- Legacy reference:
vuMailDump.pdf, section heading vuGetSaveFolder / vuGlobalsGetEmailFolder.