Microsoft Speech Platform
SpCreateNewTokenEx (by CategoryId)
SpCreateNewTokenEx creates a new token using the category ID and a token name. It subsequently completes the information with the helper function SpSetCommonTokenData.
Found in: sphelper.h
SpCreateNewTokenEx(
const WCHAR *pszCategoryId,
const WCHAR *pszTokenKeyName,
const CLSID *pclsid,
const WCHAR *pszLangIndependentName,
LANGID langid,
const WCHAR *pszLangDependentName,
ISpObjectToken **ppToken,
ISpDataKey **ppDataKeyAttribs
);
Parameters
- pszCategoryId
- [in] The null-terminated string indicating the category ID.
- pszTokenKeyName
- [in out] The token name being created. If NULL, a unique token key name will be generated. If a name is provided it will append "Tokens" before it.
- pclsid
- [in] Sets the token's CLSID, if specified.
- pszLangIndependentName
- [in] Sets the null-terminated token language dependent name.
- langid
- [in] The language ID of the word. May be zero to indicate the word can be of any LANGID.
- pszLangDependentName
- [in] Sets the null-terminated token language dependent name.
- ppToken
- [out] The newly created token. The token is created if it currently does not exist.
- ppDataKeyAttribs
- [in] Opens the attributes key. The key is created if it does not currently exist. May be NULL if not needed.
Return values
Value | Description |
---|---|
S_OK | Function completed successfully. |
FAILED (hr) | Appropriate error message. |