Browse
 
Tools
Rss Categories

LV_SRE_SetClientPropertyExPermanent

Reference Number: AA-00722 Views: 8359 0 Rating/ Voters

Sets configuration properties for the client application and marks the properties' changes as permanent (to eventualy write the changes to config file by calling LV_SRE_CommitClientPropertySettings). The function is similar to LV_SRE_SetPropertyEx (called with PROP_EX_TARGET_CLIENT as the target), except that this also marks the change as permanent.

Function

  • int LV_SRE_SetClientPropertyExPermanent(int PropertyName, int ValueType, void* pvalue)

Parameters

PropertyName

Which property to modify. See Speech Port Properties for list of properties.

ValueType

The value type of the property being set.  Legal values are:

PROP_EX_VALUE_TYPE_INT

PROP_EX_VALUE_TYPE_INT_PTR

PROP_EX_VALUE_TYPE_STRING

PROP_EX_VALUE_TYPE_FLOAT_PTR

Each property has a set of legal set of value types.  See Speech Port Properties for value types available for each property.

pvalue

A pointer to the new value for the PropertyName specified. pvalue will be reinterpreted according to the ValueType provided.

Return Values

LV_SUCCESS

No errors. Property was set to specified value

LV_INVALID_HPORT

The input hport is not a valid one.

LV_INVALID_PROPERTY_VALUE

The value is invalid for the designated property (e.g. out of range).

LV_INVALID_PROPERTY_VALUE_TYPE

The property's type is incompatible with the declared type.

LV_INVALID_PROPERTY

The property does not exist.

LV_EXCEPTION

An exception occurred while processing the request.

Remarks

This function is available in versions 10.4 or later. LV_SRE_CommitClientPropertySettings must be called along with this function, but it only needs to be called once during the program, since it serves to commit the changes made by all previous calls of this function.

See Also