Helper SpCreateNewTokenEx

Microsoft Speech SDK

The Microsoft.com Speech website Microsoft Speech SDK SAPI 5.1

SpCreateNewTokenEx (by TokenId)

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     *pszTokenId,
   const CLSID     *pclsid,
   const WCHAR     *pszLangIndependentName,
   LANGID           langid,
   const WCHAR     *pszLangDependentName,
   ISpObjectToken **ppToken,
   ISpDataKey     **ppDataKeyAttribs
);

Parameters

pszTokenId
[in] The null-terminated string indicating the token ID.
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 that 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 does not currently 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.