|
Using Stg_sg() |
Top Previous Next |
Stg_sg() allows you to set (write) or get (read) a setting and directly returns its execution result so you can check if the setting operation was successful (hence, the name "_sg", which means "set/get"). In the following example, we set the setting "IP" to "192.168.1.40":
dim result as en_stg_status_codes ... result=stg_sg("IP",0,"192.168.1.40",EN_STG_SET) select case result case EN_STG_STATUS_OK: 'all good case EN_STG_STATUS_UNKNOWN, EN_STG_STATUS_INVALID_INDEX: 'bad setting name or index case EN_STG_STATUS_FAILURE: 'failure ro write case EN_STG_STATUS_INVALID: 'new setting value is invalidinvalid value case else: 'some weird error end select ...
|
Here is another example where we read the value of the same setting. Notice that stg_sg() returns the setting value indirectly, through one of its arguments. Notice also the use of the STG_MAX_SETTING_VALUE_LEN -- we conserve memory by declaring string s of this size:
dim result as en_stg_status_codes dim s as string(STG_MAX_SETTING_VALUE_LEN) ... result=stg_sg("IP",0,s,EN_STG_GET) select case result case EN_STG_STATUS_OK: 'all good, s now contains current setting value case EN_STG_STATUS_UNKNOWN, EN_STG_STATUS_INVALID_INDEX: 'bad setting name or index case EN_STG_STATUS_FAILURE: 'failure ro write case EN_STG_STATUS_INVALID: 'new setting value is invalid case else: 'some weird error end select ...
|