Microsoft Speech SDK SAPI 5.1

---

SpGetCategoryFromId

SpGetCategoryFromId creates an object of CLSID_SpObjectTokenCategory. This function assists in locating and creating an object token category without having to search or change the registry directly.

Found in: sphelper.h

SpGetCategoryFromId(
   const WCHAR       *pszCategoryId,
   ISpObjectToken   **ppCategory,
   BOOL              *fCreateIfNotExist = FALSE
);

Parameters

pszCategoryId

[in] The string indicating the CategoryId.

ppCategory

[out] The token being created. It is created with CoCreateInstance and must be manually freed when no longer required.

fCreateIfNotExist

[in] An optional parameter allowing the object to be created if one does not currently exist. The default is FALSE unless otherwise specified.

Return values

Value	Description
S_OK	Function completed successfully.
FAILED (hr)	Appropriate error message.