LV_SRE_SetClientPropertyExPermanent

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 occured while processing the request.

Remarks

This function is available in versions 10.4 or later.

See Also

• Speech Port Properties
• LV_SRE_SetPropertyEx
• LV_SRE_CommitClientPropertySettings
• LVSpeechPort::SetClientPropertyExPermanent (C++ API)