Microsoft Speech SDK SAPI 5.1

---

ISpSREngine::GetPropertyString

ISpSREngine::GetPropertyString retrieves a string property value from the SR engine. 

HRESULT GetPropertyString(
   SPPROPSRC        eSrc,
   void            *pvSrcObj,
   const   WCHAR   *pName,
   WCHAR          **ppCoMemValue
);

Parameters

eSrc

[in] One of the types specified in the SPPROPSRC enumeration sequence. (This will currently always be SPPROPSRC_RECO_INST).

pvSrcObj

[in] Pointer to additional information. (Currently always NULL).

pName

[in] String containing the property name.

ppCoMemValue

[out] Pointer to a string that the SR engine should supply with the property value string. The string should be allocated with CoTaskMemAlloc; SAPI will delete the allocated memory after return from this function. If the engine does not support this property attribute, the parameter should be NULL.

Return values

Value	Description
S_OK	Function completed successfully. Engine supports this property attribute and has returned a value for it.
S_FALSE	Function completed successfully but engine does not support this property.
FAILED(hr)	Appropriate error message.

Remarks

Applications can use properties to control run-time results of the SR engine. The application can set and retrieve values for specific attributes on the engine. Some values are predefined by SAPI and others may be added by an engine. See SAPI 5.0 SR Properties White Paper for more details.

SAPI calls this method on an engine when the application calls ISpProperties::GetPropertyString using its recognition context object.