Putenvfile - VeriFone MX800 series Programmer's Manual

F S
ILE YSTEMS

putEnvFile

putEnvFile
20
M X 800 S P
ERIES ROGRAMMERS
Prototype
int result = putEnvFile(char *section, char *label, char *value, unsigned
short vlen, unsigned short options);
Parameters
Points to a null terminated string containing the .ini file section
section
name. Maximum length of the section name is 31 bytes.
Note:
Points to a null terminated string containing the label (reference
label
name) of the entry. Maximum length of the label is 32 bytes and
will automatically be converted to lowercase before being stored.
To create a new section, pass a pointer to null (i.e. empty string
"") for the label parameter.
Points to a null terminated string containing the value associated
value
with the label. Maximum length is 512 bytes.
To delete an entry pass a pointer to null for the value parameter
(i.e. empty string "").
Return Values
0 No error
Less than 0 An error occured:
-ENOBUFS
G
UIDE
If section is a pointer to null, the system will
automatically read from with perm or reg. perm will be
selected if the first character of label is an "*" otherwise
section reg is used.
No environment variable space