Export (0) Print
Expand All

Helper SpCreateNewToken (SAPI 5.4)

Speech API 5.4
Microsoft Speech API 5.4

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

SpCreateNewToken(
   const WCHAR       *pszCategoryId,
   const WCHAR       *pszTokenKeyName,
   ISpObjectToken    **ppToken
);

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.
ppToken
[out] The newly created token. The token will be created, if one does not currently exist.

Return values

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

Example

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.
}
Show:
© 2015 Microsoft