Share via


Note

Please see Azure Cognitive Services for Speech documentation for the latest supported speech solutions.

Microsoft Speech Platform

ISpObjectToken::SetId

ISpObjectToken::SetId sets the CategoryId for object token.

This may be called only once.

<pre IsFakePre="true" xmlns="http://www.w3.org/1999/xhtml"> <strong>HRESULT SetId(</strong> <strong> LPCWSTR </strong> *<em>pszCategoryId</em>, <strong> LPCWSTR </strong> *<em>pszTokenId</em>, <strong> BOOL</strong> <em>fCreateIfNotExist</em> <strong>);</strong> </pre>

Parameters

  • pszCategoryId
    [in] The null-terminated string name of category to set.
  • pszTokenId
    [in] The null-terminated string name of token to set.
  • fCreateIfNotExist
    [in] A Boolean indicating the object is to be created if not currently existing. TRUE allows the creation; FALSE does not.

Return Values

Value Description
S_OK Function completed successfully.
SPERR_ALREADY_INITIALIZED Category interface is already initialized.
SPERR_TOKEN_DELETED Key has been deleted.
E_INVALIDARG Either pszCategoryId and/or pszTokenId is invalid or bad.
FAILED(hr) Appropriate error message.

Notes

CategoryIds appear in the fully qualified form as:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Speech Server\v11.0\Recognizers

The only acceptable HKEYs are:

HKEY_CLASSES_ROOT,

HKEY_CURRENT_USER,

HKEY_LOCAL_MACHINE,

HKEY_CURRENT_CONFIG