ISpObjectToken::SetId (SAPI 5.3)

Microsoft Speech API 5.3

ISpObjectToken::SetId

ISpObjectToken::SetId sets the CategoryId for object token.

This may be called only once.

  
    HRESULT SetId(
   LPCWSTR       *pszCategoryId,
   LPCWSTR       *pszTokenId,
   BOOL           fCreateIfNotExist
);

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
S_OK
SPERR_ALREADY_INITIALIZED
SPERR_TOKEN_DELETED
E_INVALIDARG
FAILED(hr)

Notes

CategoryIds appear in the fully qualified form as:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Speech\Recognizers

The only acceptable HKEYs are:

HKEY_CLASSES_ROOT,

HKEY_CURRENT_USER,

HKEY_LOCAL_MACHINE,

HKEY_CURRENT_CONFIG