Helper SpCreateNewTokenEx (Microsoft Speech Platform)

Microsoft Speech Platform SDK 11

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.