Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

Helper SpCreateNewToken (SAPI 5.3)

Speech API 5.3
Microsoft Speech API 5.3

SpCreateNewToken (by CategoryId)

SpCreateNewToken creates a token coercively. The token is created with the specified name, if provided. Otherwise it will automatically generate both a key name and name.

Found in: sphelper.h

   const WCHAR       *pszCategoryId,
   const WCHAR       *pszTokenKeyName,
   ISpObjectToken    **ppToken


[in] The null-terminated string indicating the category ID.
[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.
[out] The newly created token. The token will be created, if one does not currently exist.

Return values

S_OKFunction completed successfully.
FAILED (hr)Appropriate error message.


The following code snippet illustrates the use of SpCreateNewToken (by Category Id) with the SPCAT_RECOPROFILE category.

// Declare local identifiers:
HRESULT                     hr = S_OK;
CComPtr<ISpObjectToken>     cpObjectToken;

// Create a new recognition profile.
hr = SpCreateNewToken(SPCAT_RECOPROFILES, NULL, &cpObjectToken;);

if (SUCCEEDED(hr))
   // Do stuff here.
© 2015 Microsoft