GetINIProperty

(System Library)

Description: Given an array of INIProperty structures, returns the value of a given property from that array.
Returns: Value
Usage: Script Only.
Function Groups: Configuration Management, Variable
Related to: CaptureSettings | ReadPropertiesFile |  SetINIProperty |  WritePropertiesFile
Format: \System.GetINIProperty(InputArray,  Name[, Comment, pFail])
Parameters:  
InputArray
Required. An array of INIProperty structures. See Comment section.
Name
Required. The name of the property whose value is to be returned.
Comment
Optional pointer to a text value. The comment associated with the property will be returned in this field.
pFail
Optional Boolean pointer. If the property is not found, FALSE will be returned to the calling module in this parameter.
Comments:

The INIProperty structure is as follows

INIProperty Struct [
    Name        { Variable name in the .startup/.dynamic file  };
    Value       { Simple value                                 };
    Comment     { Text comment if present in the file          };
    Hidden      { TRUE if not visible in Edit Properties GUI   };
  ];

Example:

  { Read Settings.Startup file }
TempProperties = ReadPropertiesFile(Concat(AppPath, 
                                           #APP_INI_FILENAME,
                                           #STATIC_INI_EXT));
GUID    = GetINIProperty(TempProperties\Sections["Application"], "GUID");
OEMGUID = GetINIProperty(TempProperties\Sections["Application"], "OEMGUID");