ISpProperties::SetPropertyString (SAPI 5.4)
Microsoft Speech API 5.4
ISpProperties::SetPropertyString
ISpProperties::SetPropertyString sets a text property corresponding to the specified name.
HRESULT SetPropertyString(
LPCWSTR *pName,
[annotation("__deref_out"), out, string] LPCWSTR *pValue
);
Parameters
- pName
[in, string] Null-terminated string containing the property name. - pValue
[in, string] Null-terminated string containing the property value.
Return values
Value |
S_OK |
S_FALSE |
E_INVALIDARG |
FAILED(hr) |
Remarks
If the SR engine supports the property, SAPI will fire a property-changed event (see SPEI_PROPERTY_STRING_CHANGE) to all interested recognizer contexts (ISpRecoContext). Broadcasting the corresponding event notifies any recognizer contexts that had interests in the property (see CSpEvent::PropertyName and CSpEvent::PropertyStringValue).