Microsoft Speech Platform

---

SpGetDefaultTokenFromCategoryId

SpGetDefaultTokenFromCategoryId gets the default token for the specified category ID.

Found in: sphelper.h

inline HRESULT SpGetDefaultTokenFromCategoryId(
   const WCHAR       *pszCategoryId,
   ISpObjectToken   **ppToken,
   BOOL              *fCreateCategoryIfNotExist = TRUE
);

Parameters

pszCategoryId

[in] The null-terminated string for the category ID.

ppToken

[out] The default token for the category ID.

fCreateCategoryIfNotExist

[in] An optional parameter allowing the category to be created if one does not currently exist. By default, the value is TRUE unless otherwise indicated.

Return values

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