Microsoft Speech Platform

---

ISpRecognizer3::SetActiveCategory

New in Microsoft Speech Platform

ISpRecognizer3::SetActiveCategory sets the active recognizer category to the specified category.

HRESULT SetActiveCategory(
      ISpRecoCategory   *pCategory   
);

Parameters

pCategory

[in] A pointer to an ISpRecoCategory instance.

Return values

Value	Description
S_OK	Function completed successfully.
E_INVALIDARG	pCategory is invalid.
FAILED(hr)	Appropriate error message.

Remarks

Passing a value of NULL for *pCategory places the recognizer in a mode such that it waits for either command or dictation. That is, the recognizer waits for either dictation (free text) or a command such as "start Notepad."