ISpObjectTokenInit::InitFromDataKey (SAPI 5.4)

  • Article

Microsoft Speech API 5.4

ISpObjectTokenInit::InitFromDataKey

ISpObjectTokenInit::SetObjectToken initializes a token to use a specified datakey.

  
    HRESULT InitFromDataKey(
   const WCHAR   *pszCategoryId,
   const WCHAR   *pszTokenId,
ISpDataKey    *pDataKey
);

Parameters

  • pszCategoryId
    [in] The null-terminated string name of the categoryId from which to create the token.
  • pszTokenId
    [in] The null-terminated string name of the TokenId.
  • pDataKey
    [in] Address of an ISpDataKey interface that specifies the system registry key from which to create the token.

Return values

Value
S_OK
E_POINTER
SPERR_ALREADY_INITIALIZED
SPERR_TOKEN_DELETED
E_OUTOFMEMORY

Remarks

Dynamic token enumerators can use this to create tokens under their token enumerator's token. Once created, this enables ISpDataKey::CreateKey to make a new data key, create a new object token, and then use InitFromDataKey.