ISpObjectTokenCategory::SetDefaultTokenId

Microsoft Speech SDK

The Microsoft.com Speech website Microsoft Speech SDK SAPI 5.1

ISpObjectTokenCategory::SetDefaultTokenId

ISpObjectTokenCategory::SetDefaultTokenId sets a specific token ID as the default for the category.

HRESULT SetDefaultTokenId(
   const WCHAR   *pszTokenId
);

Parameters

pszTokenId
[in] The null-terminated string name of the token ID to be used as the default.

Return values

Value Description
S_OK Function completed successfully.
SPERR_UNINITIALIZED Data key interface is not initialized.
E_INVALIDARG pszTokenId is invalid or bad.
FAILED(hr) Appropriate error message.

Remarks

The defaults are stored either directly in the category by setting the DefaultTokenID value in the category data key, or indirectly by the DefaultTokenIDLocation. Default tokens are discussed in Object Tokens and Registry Settings White Paper.