ProSoft Technology MVI69-ADM - Manual (Page 179)

MVI-ADM ♦ 'C' Programmable Application Development Function Library - ADM API
'C' Programmable Application Development Module Developer's Guide
ProSoft Technology, Inc. Page 179 of 342
February 20, 2013
ADM_FileGetChar
Syntax
char ADM_FileGetChar(ADMHANDLE adm_handle, char *SubSec, char *Topic);
Parameters
adm_handle Handle returned by previous call to ADM_Open
SubSec Subsection denoted by [ ].
Topic The individual line item under the subsection.
Description
ADM_FileGetChar allows an application to fetch a topic under a subsection of a
configuration file located in flash. This function is valid for MVI94 only.
adm_handle must be a valid handle returned from ADM_Open.
SubSec must be a pointer to the subsection.
Topic must be a pointer to the topic.
Return Value:
Character data.
"N" if no character found.
[Port]
Use CTS Line : N #Monitor CTS modem line (Y/N)
If the subsection is [Port] and the topic is Use CTS Line, then the value after the
colon will be returned. In this example N will be returned from the function call.
Example:
Get the data from [Port]
Use CTS Line: N
The return value will be N.
ADMHANDLE adm_handle;
ports[0].CTS = ADM_FileGetChar(adm_handle, "[Port]", "Use CTS Line");
See Also
ADM_FileGetString (page 177)
ADM_FileGetInt (page 178)