Difference between revisions of "ISInterface:GetSetting"

From Lavish Software Wiki
Jump to navigation Jump to search
Line 1: Line 1:
 
===Syntax===
 
===Syntax===
 
*bool GetSetting(unsigned long &SetGUID, char *Setting, char *buf, unsigned long buflen)
 
*bool GetSetting(unsigned long &SetGUID, char *Setting, char *buf, unsigned long buflen)
 +
*bool GetSetting(unsigned long &SetGUID, char *Setting, bool &bValue)
 +
*bool GetSetting(unsigned long &SetGUID, char *Setting, int &iValue)
 +
*bool GetSetting(unsigned long &SetGUID, char *Setting, float &fValue)
 +
*bool GetSetting(unsigned long &SetGUID, char *Setting, unsigned long &ulValue)
 +
*bool GetSetting(unsigned long &SetGUID, char *Setting, __int64 &Value)
 +
 
== Purpose ==
 
== Purpose ==
To get the value
+
To get the value of a specific setting in a set
 
== Usage ==
 
== Usage ==
 
=== Parameters ===
 
=== Parameters ===
Line 10: Line 16:
 
:'''[in]''' Name of the setting
 
:'''[in]''' Name of the setting
 
*char *buf
 
*char *buf
:'''[out]''' Buffer to hold the value of the setting
+
:'''[out]''' Buffer to hold the value of a setting
 
*unsigned long buflen
 
*unsigned long buflen
 
:'''[in]''' Length of the buffer
 
:'''[in]''' Length of the buffer
 
+
*bool &bValue
 +
:'''[out]''' boolean variable to hold the value of a setting
 +
*int &iValue
 +
:'''[out]''' integer variable to hold the value of a setting
 +
*float &fValue
 +
:'''[out]''' float variable to hold the value of a setting
 +
*unsigned long &ulValue
 +
:'''[out]''' unsigned long variable to hold the value of a setting
 +
*__int64 &Value
 +
:'''[out]''' 64-bit integer variable to hold the value of a setting
 
=== Return Value ===
 
=== Return Value ===
 
*bool
 
*bool

Revision as of 01:31, 3 September 2005

Syntax

  • bool GetSetting(unsigned long &SetGUID, char *Setting, char *buf, unsigned long buflen)
  • bool GetSetting(unsigned long &SetGUID, char *Setting, bool &bValue)
  • bool GetSetting(unsigned long &SetGUID, char *Setting, int &iValue)
  • bool GetSetting(unsigned long &SetGUID, char *Setting, float &fValue)
  • bool GetSetting(unsigned long &SetGUID, char *Setting, unsigned long &ulValue)
  • bool GetSetting(unsigned long &SetGUID, char *Setting, __int64 &Value)

Purpose

To get the value of a specific setting in a set

Usage

Parameters

  • unsigned long &SetGUID
[in] unique identifier of the set to get the setting from
  • char *Setting
[in] Name of the setting
  • char *buf
[out] Buffer to hold the value of a setting
  • unsigned long buflen
[in] Length of the buffer
  • bool &bValue
[out] boolean variable to hold the value of a setting
  • int &iValue
[out] integer variable to hold the value of a setting
  • float &fValue
[out] float variable to hold the value of a setting
  • unsigned long &ulValue
[out] unsigned long variable to hold the value of a setting
  • __int64 &Value
[out] 64-bit integer variable to hold the value of a setting

Return Value

  • bool
Returns true on success, false on failure

Examples

char settingbuffer[1024];
pISInterface->(parentsetguid,"favorite food",settingbuffer,sizeof(settingbuffer));

See Also